Table of Contents 
封面 1.1 
译 痢 序 12 
序 _1.3 
Hin 1.4 
致谢 .1.5 
Ble 引言 1.6 
第 2 童 创建 和 销毁 对 象 .1.7 





第 2 条 : 遇 到 多 个 构造 器 参数 时 要 考虑 用 构建 器 1.9 


第 3 条 : 构造 器 或 AEE FY Singleton J% VE 
1.10 


第 4 条 : 通过 私有 构造 器 强化 不 可 实例 化 的 能 力 _1.11 


第 5 条 : 避免 创建 不 必要 的 对 象 1.12 





第 9 条 : 78 Hequalsiht M A% hashCode 1.17 


第 10 条 : 始终 要 履 盖 toString 1.18 


19. 


20. 


21. 


22. 


23. 


24. 


25. 


26. 


27. 


28. 


29. 


30. 


31. 


32. 


33. 


34. 


35. 


36. 


37. 


38. 


第 11 条 : AHA iclone. 1.19 
第 12 条 : 考虑 实现 Comparable 接 口 _1.20 
第 4 章 类 和 接口 1.21 
员 的 可 访问 性 最 小 化 1.22 
第 14 条 : 在 公有 类 中 使 用 访问 方法 而 非 公有 域 1.23 
条 : 使 可 变性 最 小 化 _1.24 


第 16 条 : 复合 优 于 继承 1.25 











止 继 承 1.26 
第 18 条 : 接口 优 于 抽象 类 1.27 


定义 类 型 1.28 


第 20 条 : 类 层次 优 于 标签 类 1.29 





第 21 条 : FA pRB 示 策 略 1.30 








ae So 7 


Bom yA 1.32 








第 24 条 : 消除 非 受 检 警 告 1.34 








39. 


40. 


41. 


42. 


43. 


44. 


45. 


46. 





Git 枚 举 和 注解 .1.40 

第 30 条 : 用 enum 代 蔡 int 销 量 1.41 

第 31 条 : 用 实例 域 代 蔡 序数 1.42 
Enumset 代 蔡 位 域 1.43 

第 33 条 : 用 EnumMap 代 蔡 序 数 索 引 _1.44 

第 34 条 : 用 接口 模拟 可 伸缩 的 枚 举 1.45 








Effective Java 中 文 版 第 2 版 


(32) Joshua Bloch 3% 
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Java 方 面 的 书籍 ， 但 是 我 需要 这 ce, 
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详 痢 序 


Java 从 诞生 到 日 趋 完善 ， 经 过 了 不 断 的 发 展 壮大 ， 目 前 全 世界 拥有 
了 成 干 上 万 的 Java 开 发 人 员 。 如 何 编 写 出 更 清晰 、 更 正确 、 更 健壮 
且 更 易于 重用 的 代码 ， 是 大 家 所 退 求 的 目标 之 一 。 作 为 经 典 Jolt 获 

奖 作 品 的 新 版 书 ， 它 已 经 进行 了 彻底 的 更 新 ， 涵 盖 了 目 第 1 版 之 后 

所 引 入 的 Java SE 5 和 Java SE 6 的 新 特性 。 作 者 探索 了 新 的 设计 模式 
和 语言 习惯 用 法 ， 介 绍 了 如 何 充分 利用 从 泛 型 到 枚 举 、 从 注解 到 自 
动 装 箱 的 各 种 个 性 。 本 书 的 作者 Joshua Bloch 曾 经 是 Sun 公 司 的 杰出 
工程 师 ， 带 领 团 队 设计 和 实现 过 无 数 的 Java 平 台 特 性 ， 包 括 JDK 5.0 








语言 增强 版 和 获奖 的 Java Collections Framework。 他 也 是 Jolt 奖 的 获 
得 者 ， 现 在 担任 Google 公 司 的 首席 Java 架 构 师 。 他 为 我 们 带 来 了 共 
78 条 程序 员 必 备 的 经 验 法 则 : 针对 你 每 天 都 会 过 到 的 编程 问题 提出 
了 最 有 效 、 最 实用 的 解决 方案 。 


书 中 的 每 一 章 都 包含 儿 个 “条 目 ”， 以 简洁 的 形式 呈现 ， 目 成 独立 的 
短文 ， 它 们 提出 了 具体 的 建议 、 对 于 Java 平 台 精 妙 之 处 的 独到 见 
解 ， 并 提供 优秀 的 代码 范例 。 每 个 条 目的 综合 描述 和 解释 都 前 明了 
应 该 怎么 做 、 不 应 该 怎么 做 ， 以 及 为 什么 。 通 过 贯穿 全 书 透 彻 的 反 
术 齐 析 与 完整 的 示例 代码 ， 仔 细 研 读 并 加 以 理解 与 实践 ， 必 定 会 从 
中 受益 菲 浅 。 书 中 介绍 的 示例 代码 清晰 易 懂 ， 也 可 以 作为 日 党 工作 
的 参考 指南 。 


适合 人 群 


本 书 不 是 针对 初学 者 的 ， 读 者 至 少 需 要 熟悉 Java 程 序 设计 语言 。 如 
果 你 连 equlas() ~ toString() ~ hashcode() 都 还 不 了 解 的 话 ， 建议 
先 去 看 些 优秀 的 Java 入 门 书籍 之 后 再 来 阅读 本 书 。 如 果 你 现在 已 经 
在 Java 开 发 方面 有 了 一 定 的 经 验 ， 而 且 想 更 加 深入 地 了 解 Java 编 程 
语言 ， 成 为 一 名 更 优秀 、 更 高 效 的 Java 开 发 人 人员， 那么 ， 建 议 你 用 
心 的 研读 本 书 。 


内 容 形 式 


本 书 分 为 11 章 共 78 个 条 目 ， 涵 盖 了 Java 5.0/6.0 的 种 种 技术 要 点 。 与 
第 1 版 相 比 ， 本 书 删除 了 *C 语 言 结构 的 替代 ”一 章 ， 增 加 了 Java 5 所 
引入 的 “ 泛 型 人“ 枚 举 和 注解 2 各 一 章 。 数 量 上 从 57 个 条 目 发 展 到 了 
78 人 个， 不仅 增加 了 23 个 条 目 ， 并 对 原来 的 所 有 资料 都 进行 了 全 面 的 
修改 ， 删 去 了 一 些 已 经 过 时 的 和 条目。 但是， 各 章节 没有 严格 的 前 后 
顺序 关系 ， 你 可 以 随意 选择 感 兴趣 的 章节 进行 阅读 。 当 然 ， 如 果 你 
想 马上 知道 第 2 版 究竟 有 哪些 变化 ， 可 以 参阅 附录 中 第 2 版 与 第 1 版 
详细 的 对 照 情况 。 


本 书 重 点 讲述 了 Java 5 所 引入 的 全 新 的 泛 型 、 枚 举 、 注 解 、 上 自动 装 
箱 、for-each 循 环 、 可 变 参数 、 并 发 机 制 ， 还 包括 对 象 、 类 、 类 

库 、 方 法 和 序列 化 这 些 经 典 主 题 的 全 新 技术 和 最 佳 实践 ， 如 何 避 免 
Java 语 言 中 篆 被 误解 的 细微 之 处 : 陷阱 和 缺陷 ， 并 重点 关注 Java 语 





























言 本 身 和 最 基本 的 类 库 : java.lang 、 java.util ， 以 及 一 些 扩展 : 


Bete Ay 
java.util.concurrent 和 java.io 等 等 。 


第 2 章 冰 述 何 时 以 及 如 何 创建 对 象 ， 何 时 以 及 如 何 避 免 创 建 对 象 ， 
如 何 确保 它们 能 够 和 ” 适 时 地 销毁 ， 以 及 如 何 管 理 销毁 之 前 必须 进行 
的 所 有 清除 动作 。 


第 3 章 阐述 对 于 所 有 对 象 都 通用 的 方法 ， 你 会 从 中 获知 对 equals 、 
hashCode 、 toString 、 clone 和 finalize 相当 深入 的 分 析 ， Mii ie 
免 今后 在 这 些 问 题 上 再 次 犯错 。 


第 4 章 阐 述 作为 Java 程 序 设计 语言 的 核心 以 及 Java 语 言 的 基本 抽象 单 
元 (类 和 接口 )， 在 使 用 上 的 一 些 指导 原则 ， 帮 助 你 更 好 地 利用 这 
些 元 素 ， 设 计 出 更 加 有 用 、 健 壮 和 灵活 的 类 和 接口 。 


第 5 章 和 第 6 章 中 分 别 前 述 在 Java 1.5 发 行 版 本 中 新 增加 的 泛 型 
(Generic) 以 及 枚 举 和 注解 的 最 佳 实践 ， 教 你 如 何 最 大 限度 地 享有 
这 些 优势 ， 又 能 使 整个 过 程 尽 可 能 地 简单 化 。 


第 7 章 讨论 方法 设计 的 几 个 方面 : 如 何 处 理 参 数 和 返回 值 ， 如 何 设 
计 方 法 签名 ， 如 何 为 方法 编写 文档 。 从 而 在 可 用 性 、 健 壮 性 和 灵活 
性 上 有 进一步 的 提升 。 


第 8 章 主要 讨论 Java 语 言 的 具体 细节 ， 讨 论 了 局 部 变量 的 处 理 、 控 
制 结构 、 类 库 的 使 用 、 各 种 数据 类 型 和 用 法 ， 以 及 两 种 不 是 由 语言 
本 身 提供 的 机 制 (reflection 和 和 native method， 反 射 机 制 和 本 地 方 
法 ) 的 用 法 ， 并 讨论 了 优化 和 命名 惯例 。 

第 9 章 阐 述 如 何 充分 发 挥 异常 的 优点 ， 可 以 提高 程序 的 可 读 性 、 可 
靠 性 和 可 维护 性 ， 以 及 减少 使 用 不 当 所 带 来 的 负面 影响 。 并 提供 了 
一 些 关 于 有 效 使 用 异常 的 知道 原则 。 


E eae em een eteel ee 
To 


第 11 章 阐述 序列 化 方面 的 技术 ， 并 且 有 一 项 值得 特别 提 及 的 特性 ， 








就 是 序列 化 代理 (serialization proxy) 模式 ， 它 可 以 帮助 你 避免 对 
象 序列 化 的 许多 缺陷 。 


举 个 例子 ， 就 序列 化 技术 来 讲 ，HTTP 会 话 状态 为 什么 可 以 被 绥 
存 ? RMI 的 异 第 为 什么 可 以 从 服务 并 传递 到 客户 问 昵 ?GUI 组 件 为 
什么 可 以 被 发 现 、 保 存 和 恢复 呢 ? 是 因为 他 们 实现 了 serializable 
接口 吗 ? 如 果 超 类 没有 提供 一 个 可 访问 的 无 参 构造 器， 它 的 子 类 可 
以 被 序列 化 吗 ? 当 一 个 实例 采用 默认 的 序列 化 形式 ， 并 且 给 某 些 域 
标记 为 transient ， 那么 当 实 例 反 序列 化 回来 后 ， 这 些 标志 为 
transient 域 的 值 各 是 些 什 么 呢 ? de 这 些 问题 如 果 你 现在 不 能 马 
上 回答 ， 或 者 不 不 能 很 确定 ， 没 有 关系 ， 仔 细 阅 读本 书 ， 你 会 对 它 
们 有 更 深入 与 透彻 的 理解 。 


BEAN YE E 


虽然 本 书 是 讨论 更 深层 次 的 Java 开 发 技术 ， 讲 述 的 内 容 深入 ， 涉 及 
面 又 相当 广泛 ， 但 是 它 并 没有 涉及 图 形 用 户 界 面 编 程 、 企 业 级 API 

以 及 移动 设备 方面 的 技术 ， 不 过 在 各 个 章节 与 条 目 中 会 不 时 地 讨论 
到 其 他 相关 的 类 库 。 


这 和 古 一 本 分 享 经 验 并 指引 你 避免 走 棕 路 的 经 典 闭 作 ， 针 对 如 何 编写 
搞笑 、 设 计 优 民 的 程序 提出 了 最 实用 、 最 权威 的 指导 方针 ， 是 Java 
开发 人 员 案 头 上 的 一 本 不 可 或 缺 的 参考 书 。 


本 书 由 我 组 织 进行 翻译 ， 第 1 章 到 第 8 章 由 杨 春花 负 贡 、 我 负责 前 
言 、 附 录 以 及 第 9 章 到 第 11 章 的 翻译 ， 并 负责 本 书 所 有 章节 的 全 面 
审 校 。 参 与 翻译 和 审 校 的 还 有 : 荣 浩 、 印 庆 举 、 万 国 辉 、 陆 志平 、 
BRA, EA PH, BRE FA MM Me K EE 
jE EEL BOX. HA. RE, TERR 


虽然 我 们 在 翻译 过 程 中 竭力 退 求 信 、 达 、 和 雅 ， 但 限于 上 自 喘 水 平 ， 也 
许 仍 有 不 足 ， 还 望 各 位 读者 不 音 指正 。 关 于 本 书 的 翻译 和 翻译 时 采 
用 的 术语 表 以 及 相关 的 技术 讨论 大 家 可 以 访问 我 的 博客 
http://blog.csdn.net/YuLimin ， 也 可 以 发 送 邮 件 到 YuLimin@163.com 
与 我 交流 。 


在 这 里 ， 我 要 感谢 在 翻译 过 程 中 一 起 讨论 和 帮助 我 的 朋友 们 ， 他 们 
re: FER, AME, EHR, SEA, WAARA RREA 



































人 曹 晓 刚 ，Spring 中 文 站 创始 人 杨 苞 《Yanger) ，SpringSide 创 始 人 
AME QTM AK) MRA RAISINS A st 〈jini) 、 林 康 司 
(koji) ~ fa (caterpillar) ， 还 有 责任 编辑 陈 佳 媛 也 为 本 书 出 
版 做 了 大 量 工作 ， 在 此 再 次 深 表 感谢 。 


快乐 分 享 ， 实 践 出 真知 ， 最 后 ， 祝 大 家 能 够 像 我 一 样 在 阅读 中 至 受 
本 书 带 来 的 乐趣 ! 














Read a bit and take it out, then come back read some more. 
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如 果 有 一 个 同事 这 样 对 你 说 , “我 的 配偶 今天 晚上 在 家 里 制造 了 一 
顿 不 同 寻 各 的 晚餐 ， 你 愿意 来 参加 吗 ? ” (Spouse of me, this night 
today manufactrures the unusual meal in a home. You will join?) 这 时 
候 你 脑子 里 可 能 会 浮现 起 三 件 事情 : 第 一 ， 满 脑子 的 疑惑 ;第 二 ， 
英语 肯定 不 是 这 位 同事 的 木鱼 ， 第 三 ， 同 事 是 在 邀请 你 参加 他 的 家 
KEN E. 


如 果 你 曾经 学 习 过 第 二 种 语言 ， 并 且 和 尝试 过 在 课 闪 之 外 使 用 这 种 语 
言 ， 你 就 该 知道 有 三 件 事情 是 必须 掌握 的 : 这 门 语言 的 结构 如 何 
(语法 ) ， 如 何 命 名 你 想 谈论 的 事物 (词汇 )， 以 及 如 何以 惯用 和 
高 效 的 方式 来 表达 日 常 的 事物 (用 法 ) o ERA ERS Ri KATH 
两 点 ， 当 你 是 出 浑身 解数 想 让 对 方 明白 你 的 意 轧 时 ， 常 常会 及 现 当 
地 人 对 你 的 表述 忍 俊 不 蔡 。 


程序 设计 语言 也 是 如 此 。 你 需要 理解 语言 的 核心 ， 它 是 面向 算法 
的 ， 还 是 面 癌 函数 的 ， 或 者 是 面 问 对 象 的 ? 你 需要 知道 词汇 表 : 标 
准 类 库 提 供 了 哪些 数据 结构 、 操 作 和 功能 〈Facility) ? PRE BRA 
悉 如 何 用 习惯 和 高 效 的 方式 来 构建 代码 。 关 于 程序 设计 语言 的 书籍 
通常 只 是 设计 前 面 两 点 ， 或 者 只 是 晴 蜂 点 水 般 地 介绍 一 下 用 法 。 也 
许 是 因为 前 面 两 点 比较 容易 编写 。 语 法 和 词汇 是 语言 本 身 固 有 的 特 
性 ， 但 是 ， 用 法 则 反映 了 使 用 这 门 语言 的 群体 的 特征 。 


























例如 ，Java 程 序 设 计 语言 是 一 门 支持 单 继承 的 面 同 对 象 程序 设计 语 
言 ， 在 每 个 方法 的 内 部 ， 它 也 支持 命令 式 的 〈《 面 癌 语句 的 ， 
Statement-Oriented) 编码 风格 。Java 类 库 提 供 了 对 图 形 显 示 、 网 
络 、 分 布 式 计算 和 安全 性 的 支持 。 但 是 ， 如 何 把 这 门 语言 以 最 佳 的 
方式 运用 到 实践 中 呢 ? 


还 有 一 点 : 程序 与 口语 中 的 句子 以 及 大 多 数 书籍 和 杂志 都 不 同 ， 它 
会 醇 着 时 间 的 推移 而 发 生变 化 。 仅 仅 编 写 出 能 够 有 效 地 工作 并 且 能 
够 被 别人 理解 的 代码 往往 是 不 够 的 ， 我 们 还 必须 把 代码 组 织 成 易于 
修改 的 形式 。 针 对 东 个 任务 可 能 会 有 10 种 不 同 的 编码 方法 ， 而 在 这 
10 中 方法 中 ， 有 7 中 方法 是 条 拙 的 、 低 效 的 或 者 是 难以 理解 的 。 而 
在 剩 下 的 3 种 编码 方法 中 ， 哪 一 种 会 是 最 接近 该 任务 的 下 一 年 度 发 
行 版 本 的 代码 呢 ? 


目前 有 大 量 的 书籍 可 以 供 你 学 习 Java 程 序 设计 语言 的 语法 ， 包 括 
{The Java Programming Language) [Arnold05] (/F#Arnold, 
Gosling 和 Holmes) ， 以 及 《The Java Language Specification) [JLS] 
《作者 Gosling、Joy 和 Bracha) 。 同 样 ， 与 Java 程 序 设计 语言 相关 的 
类 库 和 API 的 书籍 也 不 少 。 


本 书 解决 了 你 的 第 三 种 需求 : 习惯 和 蜗 效 的 用 法 。 作 者 Joshua 
Bloch 在 Sun 公 司 多 年 来 一 直 从 事 Java 语 言 的 扩展 、 实 现 和 使 用 的 工 
作 ; 他 还 大 量 地 阅读 了 其 他 人 的 代码 ， 包 括 我 的 代码 。 他 在 本 书 中 
提出 了 许多 很 好 的 建议 ， 他 系统 地 把 这 些 建议 组 织 起 来 ， 则 在 告诉 
读者 如 何 更 好 地 构造 代码 以 便 它们 能 工作 得 更 好 ， 也 便于 其 他 人 能 
够 理解 这 些 代码 ， 便 于 将 来 对 代码 进行 修改 和 改善 的 时 候 不 至 于 那 
i E 
WHER o 
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AU a 


自从 我 于 2001 年 号 了 本 书 的 第 1 版 之 后 ，Java 平 台 又 发 生 了 很 多 变 

化 ， 是 该 出 第 2 版 的 时 候 了 。Java 5 中 最 为 重要 的 变化 是 增加 了 泛 

型 、 枚 举 类 型 、 注 解 、 自 动 装 箱 和 for-each 循 环 。 其 次 是 增加 了 新 

的 并 发 类 库 : java.util.concurrent o 我 和 Gilad Bracha 一 起 ， A ET 
领 团 队 设 计 了 最 新 的 语言 特性 。 我 还 有 笠 参 加 了 设计 和 开发 并 发 类 
库 的 团队 ， 这 个 团队 由 Doug Lea 领 导 。 


Java 平 台中 男 一 个 大 的 变化 在 于 广泛 采用 了 现代 IDE (Integrated 
Development Environment) ， 例 如 Eclipse、IntelliJj IDEA 和 
NetBeans， 以 及 静态 分 析 工 具 的 IDE， 如 FindBugs。 虽 然 我 还 未 参 
与 到 这 部 分 工作 ， 但 已 经 从 中 受益 菲 浅 ， 并 且 很 清楚 它们 对 Java 开 
发 体验 所 种 来 的 影响 。 


2004 年 ， 我 离开 Sun 公 司 到 了 Google 公 司 工 作 ， 但 在 过 去 的 4 年 中 ， 
我 仍然 继续 参与 Java 平 台 的 开发 ， 在 Google 公 司 和 JCP (Java 
Community Process) 的 大 力 帮 助 下 ， 继 续 并 友和 集合 API 的 开发 。 
我 还 有 幸 利 用 Java 平 台 去 开发 供 Google 内 部 使 用 的 类 库 。 现 在 我 了 
解 了 作为 一 名 用 户 的 感受 。 


我 在 2001 年 编写 第 1 版 的 时 候 ， 主 要 目的 是 与 读者 分 至 我 的 经 验 ， 
便于 让 大 家 能 够 避免 我 所 走 过 的 弯路 ， 是 大 家 更 容易 成 功 。 新 版 仍 
然 采用 大 量 来 自 Java 平 台 类 库 的 真实 范例 。 


第 1 版 所 带 来 的 反应 远 远 超出 了 我 最 大 的 语气 。 我 在 收集 所 有 新 的 
资料 以 使 本 书 保 持 最 新 时 ， 尽 可 能 地 保持 了 资料 的 真实 。 坚 无 疑 
问 ， 本 书 的 篇 幅 肯 定 会 增加 ， 从 57 个 条 目 发 展 到 了 78 个 。 我 不 仅 增 
加 了 23 个 条 目 ， 并 且 修 改 了 原来 的 所 有 资料 ， 并 删 去 了 一 些 已 经 过 
o 目 。 在 附录 中 ， 你 可 以 看 到 本 书 中 的 内 容 与 第 1 版 的 内 容 的 
对 照 情况 。 


在 第 1 版 的 前 言 中 我 说 过 :Java 程序 设计 语言 和 它 的 类 库 非 党 有 益 
于 代码 质量 和 效率 的 提高 ， 并 且 使 得 用 Java 进 行 编码 成 为 一 种 乐 
趣 。Java5 和 6 发 行 版 本 中 的 变化 是 好 事 ， 也 使 得 Java 平 台 日 趋 完 
善 。 现 在 这 个 平台 比 2001 年 的 要 大 得 多 ， 也 复杂 得 多 ， 但 是 一 旦 掌 
握 了 使 用 新 特性 的 模式 和 习惯 用 法 ， 它 们 束 会 使 你 的 程序 变 得 更 完 
美 ， 使 你 的 工作 变 得 更 轻松 。 我 希望 第 2 版 能 够 体现 出 我 对 Java 平 
台 持 续 的 热情 ， 并 将 这 种 热情 传递 给 你 ， 帮 助 你 更 加 高 效 和 愉快 地 
使 用 Java 平 台 及 其 新 的 特性 。 
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第 2 章 创建 和 销毁 对 象 


本 章 的 主题 是 创建 和 销毁 对 象 : 何 时 以 及 如 何 创建 对 象 ， 何 时 以 及 
如 何 避 免 创建 对 象 如 何 确 保 它 们 能 够 适时 地 销毁 ， 以 及 如 何 管 理 
对 象 销毁 之 前 必须 进行 的 各 种 清理 动作 。 


第 1 条 : GEE HR ASL) TIR 
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对 于 类 而 言 ， 为 了 让 客户 端 获 取 它 目 且 的 一 个 实例 ， 最 第 用 的 方法 
束 是 提供 一 个 公有 的 构造 饥 。 还 有 一 种 方法 ， 也 应 该 在 每 个 程序 员 
的 工具 箱 中 占有 一 席 之 地 。 类 可 以 提供 一 个 公有 的 静态 工厂 方法 
(static factory method) ， 它 只 是 一 个 返回 类 类 的 实例 的 静态 方法 。 

下 面 是 一 个 来 自 Boolean 〈 基 本 类 型 boolean 的 包装 类 ) 的 简单 示 
全 这 个 方法 将 boolean 基本 类 型 值 转换 成 了 一 个 Boolean 对 象 引 

















public static Boolean valueOf ( boolean b) { 
return b ? Boolean.TRUE : Boolean.FALSE; 
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注意 ， 静 态 工厂 方法 与 设计 模式 [Gamma95，p.107] 中 的 工矿 方法 模 
人 
IEF is 





类 可 以 通过 静态 工厂 方法 来 提供 它 的 客户 端 ， 而 不 是 通过 构造 器 。 
提供 静态 工厂 方法 而 不 是 公有 的 构造 器 ， 这 样 可 以 具有 几 大 优势 。 


静态 工厂 方法 与 构造 器 不 同 的 第 一 大 优势 在 于 ， 它 具有 名 称 。 如 
条 构 造句 的 参数 本 身 没 有 确切 地 描述 正 被 返回 的 对 象 ， 那 么 具有 适 
当 名 称 的 静态 工厂 会 更 容易 使 用 ， 产 生 的 客户 站 代码 也 更 易于 阅 
BE o 例如 ， 构造 器 BigInteger(int, int, Random) 返回 的 BigInteger 可 能 
ARB, WRAZAN siginteger.probableprime 的 静态 工厂 方法 来 表 
示 ， 显 然 更 为 清楚 。 (1.4 的 发 行 版 本 中 最 终 增加 了 这 个 方法 。) 


一 个 类 只 能 有 一 个 珊 有 指定 签名 的 构造 器 。 编 程 人 员 通 利 知 道 如 何 
避 开 这 一 限制 ， 运 过 提供 两 个 构造 上 融 ， 它 们 的 参数 列表 只 在 参数 类 
型 的 顺序 上 有 所 不 同 。 实 际 上 这 并 不 是 个 好 主意 。 面 对 这 样 的 
API， 用 户 永远 也 记 不 住 该 用 哪个 构造 器 ， 结 果 常 常会 调用 错误 的 
构造 器 。 并 且 ， 读 到 使 用 了 这 些 构造 句 的 代码 时 ， 如 果 没 有 参考 类 
的 文档 ， 往 往 不 知 所 云 。 


静态 工厂 方法 与 构造 器 不 同 的 第 二 大 优势 在 于 ， 不 必 在 每 次 调用 
它们 的 时 候 都 创建 一 个 新 对 象 。 这 使 得 不 可 变 类 《〈 见 第 15 条 ) 可 
以 使 用 预先 构建 好 的 实例 ， 或 者 将 构建 好 的 实例 缓存 起 来 ， 进 行 重 
复 利 用 ’ 从 而 避免 创建 不 必要 的 重复 对 象 o Boolean.VvValueof(boolean) 
方法 说 明了 这 项 技术 : 它 从 来 不 创建 对 象 。 这 种 方法 类 似 于 
Flyweight 模 式 [Gamma95，p.195]。 如 果 程 序 经 常 创建 相同 的 对 象 ， 
并 且 创 建 对 象 的 代价 很 高 ， 则 这 项 技术 可 以 极 大 地 提升 性 能 。 


静态 工厂 方法 能 够 为 重复 的 调用 返回 相同 的 对 象 ， 这 样 有 助 于 类 忆 
能 严格 控制 在 某 个 时 刻 哪 些 实例 应 该 存在 。 这 种 类 被 称 作 实例 受 控 
的 类 Cinstance-controlled) 。 编 写实 例 受 控 类 有 几 个 原因 。 实 例 受 
控 使 得 类 可 以 确保 它 是 一 个 Singleton ( 见 第 3 条 ) 或 者 是 不 可 实例 
化 的 〈 见 第 4 条 ) 。 它 还 使 得 不 可 变 的 类 《〈 见 第 15 条 ) 可 以 确保 不 

会 存在 两 个 相等 的 实例 ， 即 当 且 仅 当 a==。 的 时 候 才 有 a.equals(b) 

为 true 。 如 果 类 保证 了 这 一 点 ， 它 的 客户 并 就 可 以 使 用 == 操作 
FERRE equals (Object) 7 这 样 可 以 提升 性 能 。 BLAS ( enum ) 
类 型 〈 见 第 30 条 ) 保证 了 这 一 点 。 


静态 工厂 方法 与 构造 右 不 同 的 第 三 大 优势 在 于 ， 它 们 可 以 返回 原 
返回 类 型 的 任何 子 类 型 的 对 象 。 这 样 我 们 在 选择 返回 对 象 的 类 时 
就 有 了 更 大 的 灵活 性 。 





























这 种 灵活 性 的 一 种 应 用 是 ，API 可 以 返回 对 象 ， 同 时 又 不 会 使 对 象 
的 类 变 成 公有 的 。 以 这 种 方式 隐藏 实现 类 会 使 API 变 得 非常 简洁 。 

这 项 技术 适用 于 基于 接口 的 框架 (interface-based framework, Ji 
18%) ， 因 为 在 这 种 框架 中 ， 接 口 为 静态 工厂 方法 提供 了 自然 返回 
类 型 。 接 口 不 能 有 私有 方法 ， 因 此 按照 惯例 ， 接 口 type 的 静态 工 
三方 法 放 在 一 个 名 为 types 的 不 可 实例 化 的 类 《〈 见 第 4 条 ) 中 。 


例如 ，Java Collections Framework 的 集合 接口 有 32 个 便利 实现 ， 分 
别提 供 了 不 可 修改 的 集合 、 同 步 集 合 等 等 。 几 乎 所 有 这 些 实现 都 通 
过 静态 工厂 方法 在 一 个 不 可 实例 化 的 类 ( java.util.collections ) 中 
导出 。 所 有 返回 对 象 都 的 类 是 非 公有 的 。 


现在 的 Java Collections Framework API 比 导出 32 个 独立 公有 类 的 那 

种 实现 方式 要 小 得 多 ， 每 种 便利 实现 都 对 应 一 个 类 。 这 不 仅仅 是 指 
API 数 量 上 的 减少 ， 也 是 概念 意义 上 的 减少 。 用 户 知 道 ， 被 返回 的 
对 象 是 由 相关 的 接口 精确 指定 的 ， 所 以 他 们 不 需要 阅读 有 关 的 文 

档 。 使 用 这 种 静态 工厂 方法 是 ， 其 至 要 求 客户 端 通过 接口 来 引用 被 
返回 的 对 象 ， 而 不 是 通过 它 的 实现 类 来 引用 被 返回 的 对 象 ， 这 是 一 
种 良好 的 习惯 〈 见 第 52 条 ) 。 


共有 的 静态 工厂 方法 所 返回 的 对 象 的 类 不 仅 可 以 是 非 公 有 的 ， 而 且 
该 类 还 可 以 随 着 每 次 调用 而 发 生变 化 ， 这 取决 于 静态 工厂 方法 的 参 
数值 。 只 要 是 已 声明 的 返回 类 型 的 子 类 型 ， 都 是 允许 的 。 为 了 提升 
返回 对 象 的 类 也 可 能 随 着 发 行 版 本 的 不 同 


发 新 版 本 1.5 中 引入 的 类 java.util.EnumSet ( 见 第 32 条 ) 没有 公有 构 
造 器 ， 只 有 静态 工厂 方法 。 它 们 返回 两 种 实现 烈性 之 一 ， 有 共 体 则 取 
决 于 底层 枚 举 类 型 的 大 小 ;如 果 它 的 元 素 有 64 个 或 者 更 少 ， 怠 像 大 
多 数 枚 举 类 型 一 样 ， 静 态 工 三 方法 就 会 返回 一 个 RegularEnunset SK 
fil, FA 单 人 long 进行 文 持 ， 如 果 枚 举 类 型 有 65 个 或 者 更 多 元 素 ， 工 
厂 就 返回 JumboEnumSet 实例 ， 用 long 数 组 进行 支持 。 


这 两 个 实现 类 的 存在 对 于 客户 端 来 说 是 不 可 见 的 。 如 果 

RegularEnumset 不 能 再 给 小 的 枚 举 类 型 提供 性 能 优势 ， 就 可 能 从 未 来 
的 发 行 版 本 中 将 它 删除 ， 不 会 造成 不 恨 的 影响 。 同 样 地 ， 如 果 事 实 
证 明 对 性 能 有 好 处 ， 也 可 能 在 未 来 的 发 行 版 本 中 添加 第 三 甚至 第 四 
个 enumset 实现 。 客 户 端 永远 不 知道 也 不 关心 他 们 从 工 广 方法 中 得 









































到 的 对 象 的 类 ; 他 们 只 关心 它 是 EnumSet 的 某 个 子 类 即 可 。 


静态 工厂 方法 返回 的 对 象 所 属 的 类 ， 在 编写 包含 该 静态 工厂 方法 的 
类 时 可 以 不 必 存 在 。 这 种 灵活 的 静态 工厂 方法 构成 了 服务 提供 者 框 
架 (Service Provider Framework) 的 基础 ， 例 如 JDBC (Java 数 据 库 
连接 ， Java Databse Connectivity) API。 服 务 提 供 者 框架 是 指 这 样 
一 个 系统 : 多 个 服务 提供 者 实现 一 个 服务 ， 系 统 为 服务 提供 者 的 客 
户 端 提供 多 个 实现 ， 并 把 他 们 从 多 个 实现 中 解 耦 出 来 。 


服务 提供 者 框架 中 有 三 个 重要 的 组 件 : 服务 接口 (Service 
Interface) ， 这 是 提供 者 实现 的 ， 提 供 者 注册 API (Provider 
Registration API) ， 这 是 系统 用 来 注册 实现 ， 让 客户 病 访 问 它们 
的 ;服务 访问 API (Service Access API) ， 是 客户 端 用 来 获取 服务 
的 实例 的 。 服 务 访问 API 一 般 允 许 但 是 不 要 求 客 户 端 指定 某 种 选择 
提供 者 的 条 件 。 如 果 没 有 这 样 的 规定 ，API 了 就 会 返回 默认 实现 的 一 
个 实例 。 服 务 访 问 API 是 “灵活 的 静态 工厂 ”， 它 构成 了 服务 提供 者 
框架 的 基础 。 


服务 提供 者 框架 的 第 四 个 组 件 是 可 选 的 : 服务 提供 者 接口 〈Service 
Provider Interface) ， 这 些 提 供 者 负责 创建 其 服务 实现 的 实例 。 如 

条 没 有 服务 提供 者 接口 ， 实 现 就 按照 类 名 进行 注册 ， 并 通过 反射 方 
式 进 行 实例 化 〈 见 第 53 条 ) 。 对 于 JDBC 来 说 ， connection 就 是 它 的 
服务 接 O ’ DriverManager.registerDriver 是 提供 者 注册 APTL， 

e 是 服务 访问 APL， Driver 就 是 服务 提供 者 
KI. 


服务 提供 者 框架 模式 有 痢 无 数 种 变 体 。 例 如 ， 服 务 访问 API 可 以 利 
用 适配器 (Adapter) 模式 [Gamma95，p.139]， 返 回 比 提供 者 需要 
的 更 丰富 的 服务 接口 。 下 面 是 一 个 简单 的 实现 ， 包 含 一 个 服务 提供 
者 接口 和 一 个 默认 提供 者 : 


// Service provider framework Sketch 














// Service interface 
public interface Service { 


. // Service-specific methods go here 
g 


// Service provider interface 
public interface Provider { 


Service newService () ; 


// Noninstantiable class for service registration and access 
public class Services { 


private Services () {} // Prevents instantiation (Item 4) 


// Maps service names to services 


private static final Map<String, Provider> providers = new 
ConcurrentHasMap<String, Provider>(); 


public static final String DEFAULT_PROVIDER_NAME = '"<def>" ; 


// Provider registration API 
public static void registerDefaultProvider (Provider p) { 


registerProvider (DEFAULT_PROVIDER_NAME, p); 


public static void registerProvider (String name, Provider p) 


providers.put(name, p); 


// Service access API 
public static Service newInstance () { 


return newInstance(DEFAULT_PROVIDER_NAME) ; 


public static Service newInstance (String name) { 


Provider p = providers.get(name); 
if (p == null ) 


throw new IllegalArgumentException( 
"No provider registered with name: " + name); 


return p.newService(); 


静态 工厂 方法 的 第 四 大 优势 在 于 ， 在 创建 参数 化 类 型 实例 的 
时 候 ， 它 们 使 代码 变 得 更 加 人 简洁。 遗憾 的 是 ， 在 调用 参数 化 
类 的 构造 器 时 ， 即 使 类 型 参数 很 明显 ， 也 必须 指明 。 这 通常 要 
求 你 接连 两 次 提供 类 型 参数 : 


Map<String, List<String>> m = new HashMap<String, List<String>>(); 


随 着 类 型 参数 变 得 越 来 越 长 ， 越 来 越 复 杂 ， 这 一 见长 的 说 明 也 
很 快 变 得 痛 兰 起 来 。 但 是 有 了 静态 工厂 方法 ， 编 译 器 残 可 以 蔡 
你 找到 类 型 参数 。z 和 被 称 作 类 型 推 到 〈type inference) 。 例 

如 ， 假 设 nashwap 提供 了 这 个 静态 工厂 : 


public static <K, V> HashMap<K, V> newlInstance () { 


return new HashMap<K, V>(); 





Maas PY VAS P ER E fT AREARE E Ti ae Be A = BH : 


Map<String, List<String>> m = HashMap.newInstance(); 


总 有 一 天 ，Java 能 够 在 构造 器 调用 以 及 方法 调用 中 执行 这 种 类 
型 推 到 ， 但 到 发 行 版 本 1.6 为 止 暂时 还 无 法 这 么 做 。 


遗憾 的 是 ， 到 发 行 版 本 1.6 为 止 ， 标 准 的 集合 实现 如 nasnwap 并 
没有 工厂 方法 ， 但 是 可 以 把 这 些 方法 放 在 你 自己 的 工具 类 中 。 
Ge SEAN tee eee ete ee 





静态 工矿 方法 的 主要 缺点 在 于 ， 类 如 果 不 含 有 公有 的 或 者 受 
保护 的 构造 器 ， 束 不 能 被 子 类 化 。 对 于 公有 的 静态 工厂 所 返 
回 的 非 公 有 类 ， 也 同样 如 此 。 例 如 ， 要 想 将 Collections 
Framework 中 的 任何 方便 的 实现 类 子 类 化 ， 这 是 不 可 能 的 。 但 
是 这 样 也 许 会 因祸得福 ， 因 为 它 鼓 励 程序 员 使 用 复合 
(composition) ， 而 不 是 继承 〈 见 第 16 条 ) 。 


静态 工厂 方法 的 第 二 个 缺点 在 于 ， 它 们 与 其 他 的 静态 方法 实 
际 上 没有 任何 区 别 。 在 API 文 档 中 ， 它 们 没有 像 构造 器 那样 在 
API 文 档 中 明确 标识 出 来 ， 因 此 ， 对 于 提供 了 静态 工厂 方法 而 
不 是 构造 器 的 类 来 说 ， 要 想 查 明 如 何 实例 化 一 个 类 ， 这 是 非常 
困难 的 。Javadoc 工 具 总 有 一 天 会 注意 到 静态 工厂 方法 。 同 

时 ， 你 通过 在 类 或 者 接口 注释 中 关注 静态 工厂 ， 并 遵守 标准 的 
也 可 以 弥补 这 一 劣势 。 下 面 是 静态 工厂 方法 的 一 些 























© valueof 不 太 严 格 地 讲 ， 该 方法 返回 的 实例 与 它 的 参 
这 样 的 静态 工厂 方法 实际 上 是 类 型 转化 
Jit 

Oo of valueof 的 一 种 更 为 简洁 的 奉 代 ， 在 Enunset (JL 
第 32 条 ) 中 使 用 并 流行 起 来 。 

O getInstance 返回 的 实例 是 通过 方法 的 参数 来 描述 
的 ， 但 是 不 能 够 说 与 参数 具有 同样 的 值 。 对 于 singleton 
来 说 ， 该 方法 没有 参数 ， 并 返回 唯一 的 实例 。 


newInstance 像 getInstance 样 ， 但 newInstance fe 
确保 返回 的 每 个 实例 都 与 所 有 其 他 实例 不 同 。 

getType Ba getInstance ARR 但 是 在 工厂 方法 处 于 不 
oe ee Type 表示 工厂 方法 所 返回 的 对 象 类 


O newType 一 一 像 newInstance 一 样 ， 但 是 在 工厂 方法 处 于 不 
同 的 类 中 的 时 候 使 用 。 Type 表示 工厂 方法 所 返回 的 对 象 类 
型 。 
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O 











简 而 言 之 ， 静 态 工矿 方法 和 公有 构造 喜 都 各 有 用 处 ， 我 们 需 
理解 它们 各 目的 长 处 。 静 态 工厂 通常 更 加 合适 ， MEDAR” 
SOME EA AE MACS ERAS TL) 





第 2 条 : 过 到 多 个 构造 器 参数 时 
要 知情 用 构建 从 


静态 工厂 和 构造 占有 个 共同 的 局 限 性 :它们 都 不 能 很 好 地 扩展 
到 大 量 的 可 选 参数 。 考 虑 用 一 个 类 表示 包装 食品 外 面 显示 的 营 
养 成 分 标签 。 这 些 标签 中 有 儿 个 域 是 必需 的 : 每 份 的 含量 、 每 
饶 的 含量 以 及 每 份 的 卡路里 ， 还 有 超过 20 个 可 选 域 : 总 脂肪 
量 、 饱 和 脂肪 量 、 转 化 脂肪 、 胆 固 醇 、 钠 等 等 。 大 多 数 产品 在 
某 几 个 可 选 域 中 都 会 有 非 零 的 值 。 


对 于 这 样 的 类 ， 应 该 用 哪 种 构造 器 或 者 静态 方法 来 编写 呢 ? 程 
序 员 一 加 习 惯 采 用 重 闭 构造 器 (telescoping constructor) $ 

式 ， 在 这 种 模式 下 ， 你 提供 第 一 个 只 有 必要 参数 的 构造 器 ， 第 
二 个 构造 器 有 一 个 可 选 参数 ， 第 三 个 有 两 个 可 选 参数 ， 以 此 类 
推 ， 最 后 一 个 构造 器 包含 所 有 可 选 参数 。 下 面 有 个 示例 ， 为 了 
简单 起 匈 ， 它 只 显示 四 个 可 选 域 : 


// Telescoping constructor pattern - does not scale well! 








public class NutritionFacts { 


private final int servingSize; // (mL) required 
private final int servings; // (per container) required 
private final int calories; // optional 
private final int fat; // (9) optional 
private final int sodium; // (mg) optional 
private final int carbohydrate; // (g) optional 


public NutritionFacts ( int servingSize, int servings) { 


this (servingSize, servings, © ); 


public NutritionFacts ( int servingSize, int servings, int 
calories) { 


this (servingSize, servings, calories, © ); 


public NutritionFacts ( int servingSize, int servings, int 
calories, int fat) { 


this (servingSize, servings, calories, fat, 0 ); 


public NutritionFacts ( int servingSize, int servings, int 
calories, int fat, int sodium) { 


this (servingSize, servings, calories, fat, sodium, 0 ); 


public NutritionFacts ( int servingSize, int servings, int 
calories, int fat, int sodium, int carbohydrate) { 


this .servingSize = servingSize; 
this .servings = servings; 
this .calories = calories; 
this .fat = fat; 

this .sodium = sodium; 


this .carbohydrate = carbohydrate; 


当 你 想 要 创建 实例 的 时 候 ， 就 利用 参数 列表 了 最短 的 构造 
项 ， 但 该 列表 中 包含 了 要 设置 的 所 有 参数 : 


NutritionFacts cocaCola = new NutritionFacts( 240 ， 8, 100 
MO 35 27 Dir 


这 个 构造 器 调用 通常 需要 许多 你 本 不 想 设置 的 参数 ， 但 还 
是 不 得 不 为 他 们 传递 值 。 在 这 个 例子 中 ， 我 们 给 rat 传递 
了 一 个 值 为 0。 如 果 “ 仅 仅 " 是 这 6 个 参数 ， 看 起 来 还 不 算 太 
粮 ， 问 题 是 随 着 参数 数目 的 增加 ， 它 很 快 就 失去 了 控制 。 


一 句 话 : 重合 构造 右 模 式 可 行 ， 但 是 当 有 许多 参数 的 时 


候 ， 和 客户 问 代 码 会 很 难 编写 ， 并 且 仍 然 较 难以 阅读 。 如 
果 读 者 想 知 道 那 些 值 是 什么 意思 ， 必 须 很 仔细 地 数 着 这 些 
参数 来 探 个 究竟 。 一 长 串 类 型 相同 的 参数 会 导致 一 些微 妙 
的 错误 。 如 采 客 户 器 不 小 心 题 倒 了 其 中 两 个 参数 的 顺序 ， 
oo oer 但 是 程序 在 运行 时 会 出 现 错误 的 行 


过 到 许多 构造 参数 的 时 候 ， 还 有 第 二 种 代 蔡 办 法 ， 即 
JavaBeans 模 式 ， 在 这 种 模式 下 ， 调 用 一 个 无 参 构 造 右 来 
创建 队 形 ， 然 后 调用 setter 方 法 来 设置 每 个 必要 的 参数 ， 以 
及 每 个 相关 的 可 选 参数 : 


// JavaBeans Pattern - allows inconsistency, mandates mutability 








public class NutritionFacts { 
// Parameters initialized to default values (if any) 


private int servingSize = - 1 ; 
// Required; no default value 


private int servings =a 六/ 
private int calories =O | 
private int fat =m FF 
private int sodium = 区 
private int carbohydrate = 0 ; 


public NutritionFacts () {} 


// Setters 


public void setServingSize ( int val) 
servingSize = val; } 


A 


public void setServings ( int val) 
servings = val; } 


~ 


public void setCalories ( int val) 
calories = val; } 


~ 


public void setFat ( int val) 
fat = val; } 


~ 


public void setSodium ( int val) 
sodium = val; } 


~ 


ublic void setCarbohydrate ( int val) 
{ carbohydrate = val; } 


} 
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点 ， 就 是 创建 实例 很 容易 ， 这 样 产 生 的 代码 读 起 来 也 
很 容易 : 

NutritionFacts cocaCola = new NutritionFacts(); 

cocaCola.setServingSize( 240 ); 

cocaCola.setServings( 8 ); 

cocaCola.setCalories( 100 ); 

cocaCola.setSodium( 35 ); 


cocaCola.setCarbohydrate( 27 ); 








HIRE, JavaBeans ti A BA A 44 (RIE LS o 
因为 构造 过 程 被 分 到 了 几 个 调用 中 ， 在 构造 过 程 中 
JavaBean 可 能 处 于 不 一 致 的 状态 。 类 无 法 仅仅 通过 检 
验 构造 器 参数 的 有 效 性 来 保证 一 致 性 。 试 图 使 用 处 于 
不 一 致 状态 的 对 象 ， 将 会 导致 失败 ， 这 种 失败 与 包含 
错误 的 代码 大 相 径 庭 ， 因 此 它 调 试 起 来 十 分 困难 。 与 
此 相关 的 男 一 点 不 足 在 于 ， JavaBeans 模 式 阻止 了 把 
类 做 成 不 可 变 的 可 能 〈 见 第 15 条 ) ， 这 就 需要 程序 
员 付 出 额外 的 努力 来 确保 它 的 线程 安全 。 


当 对 象 的 构造 完成 ， 并 且 不 允许 在 解冻 之 前 使 用 时 ， 
通过 手工 “冻结 ”对 象 ， 可 以 弥补 这 些 不 足 ， 但 是 这 种 
Fi aati, FESR RZD EG. Ub, EB TE 
运行 时 导致 错误 ， 因 为 编译 器 无 法 确保 程序 员 会 在 使 
用 之 前 先 在 对 象 上 调用 freeze 方 法 。 


柱 运 的 是 ， 还 有 第 三 种 蔡 代 方法 ， 既 能 保证 像 重 阁 构 
造 器 模式 那样 的 安全 性 ， 也 能 保证 像 JavaBeans 模 式 
那么 好 的 可 读 性 。 这 束 是 Builder 模 式 [Gamma95， 
p.97] 的 一 种 形式 。 不 直接 生成 想 要 的 对 象 ， 而 是 让 客 
户 端 利用 所 有 必要 的 参数 调用 构造 器 (或 者 静态 工 
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build 方法 来 生成 不 可 变 的 对 象 。 这 个 builder 是 它 构 
建 的 类 的 静态 成 员 类 〈 见 第 22 条 ) 。 下 面 就 是 它 的 示 
例 : 
// Builder pattern 
public class NutritionFacts { 
private final int servingSize; 
private final int servings; 
private final int calories; 
private final int fat; 
private final int sodium; 


private final int carbohydrate; 


public static class Builder { 
// Required parameters 
private final int servingSize; 


private final int servings; 


// Optional parameters - initialized to default values 


private int calories = 0 f 
private int fat = y 
private int sodium =O 元 
private int carbohydrate = © ; 


public Builder ( int servingSize, int 
servings) { 


this .servingSize = servingSize; 


this .servings = servings; 


public Builder calories ( int val) 


{ calories = val; return this ; } 
public Builder fat ( int val) 

{ fat = val; return this pe 
public Builder sodium ( int val) 

{ sodium = val; return this ; } 
public Builder carbohydrate ( int val) 


{ carbohydrate = val; return this pa 


public NutritionFacts build () { 


return new NutritionFacts( this ); 


private NutritionFacts (Builder builder) { 


servingSize = builder.servingSize; 
servings = builder.servings; 
calories = builder.calories; 
fat = builder.fat; 

sodium = builder .sodium; 


carbohydrate = builder.carbohydrate; 


注意 NutritionFacts 是 不 可 变 的 ， 所 有 的 默认 参数 
值 都 单独 放 在 一 个 地 方 。builder 的 setter 方 法 返回 
builder 本 身 ， 以 便 可 以 把 调用 链接 起 来 。 下 面 就 
是 客户 端 代码 : 

NutritionFacts cocaCola = new 

NutritionFacts.Builder( 240 , 8 ) 


.calories( 100 ).sodium( 35 ).carbohydrate( 27 
) .build() 





TOE AY Fe iw SRS mW ENERE, 
易于 阅读 。 builder 模 式 模拟 了 具名 的 可 选 参数 ， 
束 想 Ada 和 和 Python 中 的 一 样 。 


builder 像 个 构造 器 一 样 ， 可 以 对 其 参数 强加 约束 
条 件 。 build 方法 可 以 检验 这 些 约束 条 件 。 将 参 
数 从 builder 找 贝 到 对 象 中 之 后 ， 并 在 对 象 域 而 不 
是 builder 域 〈 见 第 39 条 ) 中 对 它们 进行 检验 ， 这 
一 点 很 重要 。 如 果 违 反 了 任何 约束 条 件 ， buiad 
方法 就 应 该 抛 出 IllegalStateException ( 见 第 60 
条 ) 。 异 第 的 详细 信息 应 该 显示 违反 了 哪个 约束 
条 件 〈 见 第 63 条 ) 。 


对 多 个 参数 强加 约束 条 件 的 另 一 种 方法 是 ， 用 多 
个 setter 方 法 对 某 个 约束 条 件 必须 持 有 的 所 有 参数 
进行 检查 。 如 果 该 约束 条 件 没有 得 到 满足 ，setter 
方法 就 会 抛 出 IllegalArgumentsException o 这 有 个 好 
处 ， 就 是 一 旦 传递 了 无 效 的 参数 ， 立 即 就 会 及 现 
约束 条 件 失 败 ， 而 不 是 等 着 调用 build 方法 。 


与 构造 器 想必 ，builder 模 式 的 略微 优势 在 于 ， 
builder 可 以 有 多 个 可 变 (varargs) 参数 。 构 造 嚣 
就 像 方法 一 样 ， 只 能 有 一 个 可 变 参 数 。 因 为 
builder 利 用 单独 的 方法 来 设置 每 个 参数 ， 你 想 要 
多 少 个 可 变 参数 ， 它 们 就 可 以 有 多 少 个 ， 知 道 每 
个 setter 方 法 都 有 一 个 可 变 参 数 。 


Builder 模 式 十 分 灵活 ， 可 以 利用 单个 builder 构 建 
多 个 对 象 。builder 的 参数 可 以 在 创建 对 象 期 间 进 
行 调整 ， 也 可 以 随 着 不 同 的 对 象 而 改变 。builder 
可 以 自动 填充 某 些 域 ， 例 如 每 次 创建 对 象 时 自动 
增加 序列 号 。 


这 事 了 参数 的 builder 生 成 了 一 个 很 好 的 抽象 工厂 
(Abstract Factory) [Gamma95，Pp.87]。 换 句 话 
说 ， 客 户 端 可 以 将 这 样 一 个 builder 传 给 方法 ， 使 
该 方法 能 够 为 客户 端 创建 一 个 或 者 多 个 对 象 。 要 
使 用 这 种 用 法 ， 需 要 有 个 类 型 来 表示 builder。 如 











果 使 用 的 是 发 行 版 本 1.5 或 者 更 新 的 版 本 ， 只 要 
一 个 泛 型 ( 见 第 26 条 ) 就 能 满足 所 有 的 builder， 
无 论 它们 在 构建 哪 种 类 型 的 对 象 : 
// A builder for objects of type T 
public interface Builder < T> { 
public T build () ; 


} 


注意 ， 可 以 声明 NutritionFacts.Builder 类 来 实现 


Builder<NutritionFacts> o 


带 有 Builder 实 例 的 方法 通常 利用 有 限制 的 通配符 
类 型 (bounded wildcard type， 见 第 28 条 ) 来 约束 
构建 器 的 类 型 参数 。 例 如 ， 下 面 就 是 构建 每 个 
节点 的 方法 ， 它 利用 一 个 客户 端 提 供 的 Builder 实 
例 来 构建 树 : 


Tree buildTree (Builder<? extends Node> nodeBuilder) 
{ ...} 





Java 中 传统 的 抽象 工厂 实现 是 class WR, H 
newInstance FERS build 方法 的 一 部 分 。 这 种 
用 法 隐 舍 着 许多 问题 。 newInstance 方法 总 是 企图 
调用 类 的 无 参 构造 器 ， 这 个 构造 器 甚至 可 能 根本 
不 存在 。 如 果 类 没有 可 以 访问 的 无 参 构造 器 ， 你 
也 不 会 收 到 编译 时 错误 。 相 反 ， 客 户 端 代码 必须 
在 运行 时 处 理 InstantiationException 或 者 
IllegalAccessException ， 这 样 既 不 雅 观 也 不 方便 。 
newinstance 方法 还 会 传播 由 无 参 构造 需 抛 出 的 任 
何 异 常 ， 即使 newInstance 缺乏 相应 的 throws 子 
fjs 换 句 话说 ， Class.newInstance 成 坏 了 编译 时 的 
异常 检查 。 上 面 讲 过 的 Builder 接 口 弥 补 了 这 些 
ARE 0 


Builder 模 式 的 确 也 有 它 目 身 的 不 足 。 为 了 创建 西 
乡 ， 必 须 先 创建 它 的 构建 器 。 虽 然 创 建构 建 句 的 











开销 在 实践 中 可 能 不 那么 明显 ， 但 是 在 某 些 十 分 
注重 性 能 的 情况 下 ， 可 能 就 成 问题 了 。Builder 模 
式 还 比重 早 构 造 嚣 更 加 见长 ， 因 此 它 只 有 在 很 多 
参数 的 时 候 才 使 用 ， 比 如 4 个 或 者 更 多 个 参数 。 
但 是 记 住 ， 将 来 你 可 能 需要 添加 参数 。 如 果 一 开 
始 就 使 用 构造 器 或 者 静态 工厂 ， 等 到 类 需要 多 个 
参数 时 才 添 加 构建 绒 ， 束 会 无 法 控制 ， 那 些 过 时 
的 构造 器 或 者 静态 工厂 显得 十 分 不 协调 。 因 此 ， 
通常 最 好 一 开始 就 使 用 构建 器 。 


简 而 言 之 ， 如 果 类 的 构造 器 或 者 静态 工厂 中 具有 
多 个 参数 ， 设 计 这 种 类 时 ，Builder 模 式 就 是 种 不 
错 的 选择 ， 特 别 是 当 大 多 数 参 数 都 是 可 选 的 时 
候 。 与 使 用 传统 的 重 登 构造 器 模式 相 比 ， 使 用 
Builder 模 式 的 客户 端 代码 将 更 易于 阅读 和 编写 ， 
构建 器 也 比 JavaBeans 更 加 安全 。 


第 3 条 : 用 私有 构造 器 或 
者 枚 举 类 型 强化 Singleton 
属性 


Singleton 指 仅仅 被 实例 化 一 次 的 类 [Gamnma95， 
P.127]。Singleton 通 常 被 用 来 代表 那些 本 质 上 唯 
一 的 系统 组 件 ， 比 如 窗口 管理 器 或 者 文件 系统 。 
使 类 成 为 Singleton 会 使 它 的 客户 端 测试 变 得 十 分 
困难 ， 因 为 无 法 给 Singleton 蔡 换 模拟 实现 ， 除 非 
它 实现 一 个 充当 其 类 型 的 接口 。 


在 Java 1.5 发 行 版 本 之 前 ， 实 现 Singleton 有 两 种 方 
法 。 这 两 种 方法 都 要 把 构造 器 保持 为 私有 的 ， 并 
导出 共有 的 静态 成 员 ， 一 过 人 允许 客户 端 能 够 访问 
该 类 的 唯一 实例 。 在 第 一 种 方法 中 ， 公 有 静态 成 


员 是 个 final ER: 




















// Singleton with public final field 


public class Elvis { 


public static final Elvis INSTANCE = new 


Elvis(); 

private Elvis () Me eee as 

public void leaveTheBuilding () 人 
} 


私有 构造 器 仅 被 调用 一 次 ， 用 来 实例 化 公有 的 静 
A final 域 Elvis. INSTANCE o 由 于 缺少 公有 的 或 者 
受 保护 的 构造 器 ， 所 以 保证 了 Elvis 的 全 局 唯一 
性 ; 一 旦 Evis 类 被 实例 化 ， 只 会 存在 一 个 
elvis Yl, PEED. ZFA 的 任何 行为 都 
不 会 改变 这 一 点 ， 但 要 提醒 一 点 : 享有 特权 的 客 
户 端 可 以 借助 AccessibleObject.setAccessible 方法 ， 
通过 反射 机 制 〈 见 第 53 条 ) 调用 私有 构造 器 。 如 
条 需要 抵御 这 种 攻击 ， 让 它 在 
被 要 求 创建 第 二 个 实例 的 时 候 创建 异 


在 实现 singleton 的 第 二 种 方法 中 ， 公 有 的 成 员 
是 个 静态 工厂 方法 : 


// Singleton with static factory 





public class Elvis { 


private static final Elvis INSTANCE = new 
Elvis(); 


private Elvis () T oana H 


public static Elvis getInstance () { 
return INSTANCE } 


public void leaveTheBuilding () ne dy 


对 于 静态 方法 Elvis.getInstance 的 所 有 调用 ， 都 会 
返回 同一 个 对 象 引用 ， 上 所以， 永远 不 会 创建 其 他 
的 Elvis 实例 《上 述 提醒 依然 适用 ) 。 


公有 域 方法 的 主要 好 处 在 于 ， 组 成 类 的 成 员 的 声 
明 很 清楚 地 表明 了 这 个 类 是 一 个 Singleton: 公有 
的 静态 域 是 rina 的 ， 所 以 该 域 总 是 包含 相同 的 
对 象 引 用 。 公 有 域 方 法 在 性 能 上 不 再 有 任何 优 
势 : 现代 的 JVM (Java 虚 拟 机 ，Java Virtual 
Machine) 实现 几乎 都 能 够 将 静态 工厂 方法 的 调 
用 内 联 化 。 


工厂 方法 的 优势 之 一 在 于 ， 它 提供 了 灵活 性 : 在 
不 改变 其 API 的 前 提 下 ， 我 们 可 以 改变 该 类 是 否 
应 该 为 Singleton 的 想法 。 工 厂 方法 返回 该 类 的 唯 
一 实例 ， 但 是 ， 它 可 以 很 容易 被 修改 ， 比 如 改 成 
为 每 个 调用 该 方法 的 线程 返回 一 个 唯一 的 实例 。 
第 二 个 优势 与 泛 型 〈 见 第 27 条 ) AR. KERA 
之 则 通常 都 不 相关 ， pubiic 域 (public-field) 的 
方法 比较 简单 。 


为 了 使 利用 这 其 中 一 种 方法 实现 的 Singleton 类 变 
成 是 可 序列 化 的 ( Serializable ) ( 见 第 11 

章 ) ’ 仅仅 在 声明 中 加 上 “ implements Serializable 

"是 不 够 的 。 为 了 维护 并 保证 Singleton， 必 须 声 

明 所 有 实例 域 都 是 瞬时 ( transient ) 的 ， 并 提 

供 一 个 readResolve 方法 ( 见 第 77 条 ) o AM, 
次 反 序 列 化 一 个 序列 化 的 实例 时 ， 都 会 创建 一 个 
新 的 实例 ， 比 如 说 ， 在 我 们 的 例子 中 ， 会 导 

致 “假冒 的 Elvis”*。 为 了 防止 这 种 情况 ， 要 在 

Elvis 类 中 加 入 下 面 这 个 readResolve 方法 : 


// readResolve method to preserve sigleton property 








private Object readResolve () { 


// Return the one true Elvis and let the garbage collector 
// take care of the Elvis impersonator. 
return INSTANCE; 


} 


从 Java 1.5 发 行 版 本 起 ， 实 现 Singleton 还 有 第 三 种 


方法 。 只 需 编 写 一 个 包含 单个 元 素 的 枚 举 类 型 : 
// Enum singleton the prefered approach 
public enum Elvis { 


INSTANCE; 


public void leaveTheBuilding () faee } 


} 


这 种 方法 在 功能 上 与 公有 方法 相近 ， 但 是 它 更 加 
简洁 ， 无 偿 地 提供 了 序列 化 机 制 ， 绝 对 防止 多 次 
实例 化 ， 即 使 在 面 对 复 杂 的 序列 化 或 者 反射 攻击 
的 时 候 。 虽 然 这 种 方法 还 没有 广泛 采用 ， 但 是 单 
的 枚 举 类 型 已 经 成 为 实现 Singleton 的 最 佳 方 
法 。 


第 4 条 : WON A ie ae 
BL AS BY SEB AC REJI 


有 了 时候， 你 可 能 需要 编写 只 包含 静态 方法 和 静态 
域 的 类 。 这 些 类 的 名 声 很 不 好 ， 因 为 有 些 人 在 面 
回 对 象 的 语言 中 滥用 这 样 的 类 来 编写 过 程 化 的 程 
序 。 尽 管 如 此 ， 它 们 也 确实 有 它们 特有 的 用 处 。 
我 们 可 以 利用 这 种 类 ， 以 java.lang.math 或 者 
java.util.Arrays 的 方式 ， 把 基本 类 型 的 值 或 数组 
类 型 上 的 相关 方法 组 织 起 来 。 我 们 也 可 以 通过 
java.util.Collections Wy Ar sk, 把 基 实 现 特定 接口 
的 对 象 上 的 静态 方法 (包括 工厂 方法 ， 见 第 1 
条 ) 组 织 起 来 。 最 后 ， 还 可 以 利用 这 种 类 把 
做 法 类 上 的 方法 组 织 起 来 ， 以 取代 扩展 该 类 的 
HIA o 


这 样 的 工具 类 (utility class) 不 希望 被 实例 化 ， 
实例 对 它 没 有 任何 意义 。 然 而 ， 在 缺少 显 式 构造 
器 的 情况 下 ， 编 译 占 会 自动 提供 一 个 公有 的 、 无 




















参 的 缺 省 构造 器 (default constructor) 。 对 于 用 
户 而 言 ， 这 个 构造 器 与 其 他 的 构造 器 没有 任何 区 
别 。 在 已 发 行 的 API 中 常常 可 以 看 到 一 些 被 无 意 
识 地 实例 化 的 类 。 


企图 通过 将 类 做 成 抽象 类 来 强制 该 类 不 可 被 实例 
化 ， 这 是 行 不 通 的 。 该 类 可 以 被 子 类 化 ， 并 且 
该 子 类 也 可 以 被 实例 化 。 这 样 做 甚至 会 误导 用 
户 ， 以 为 这 种 类 是 专门 为 了 继承 而 设计 的 《〈 见 第 
17 条 ) 。 然 而 ， 有 一 些 简单 习惯 用 法 可 以 确保 类 
不 可 被 实例 化 。 由 于 只 有 当 类 不 包含 显 式 的 构造 
医 时 ， 编 译 需 才 会 生成 缺 省 的 构造 器 ， 因 此 我 们 
eee 
J; 


// Noninstantiable utility class 








public class UtilityClass { 


// Suppress default constructor for noninstantiability 
private UtilityClass () { 


throw new AssertionError(); 


. // Remainder omitted 


} 


由 于 显 式 的 构造 器 是 私有 的 ， 所 以 不 可 以 在 该 类 
的 外 部 访问 它 。 assertionerror 不 是 必需 的 ， 但 是 
它 可 以 避免 不 小 心 在 类 的 内 部 调用 构造 器 。 它 保 
证 该 类 在 任何 情况 下 都 不 会 被 实例 化 。 这 种 习惯 
用 法 有 点 违背 直觉 ， 好 像 构 造 器 就 是 专门 设计 成 
不 能 被 调用 一 样 。 因 此 ， 明 智 的 做 法 就 是 在 代码 
中 增加 一 条 注释 ， 如 上 所 示 。 

这 种 习惯 用 法 也 有 副作用 ， 它 使 得 一 个 类 不 能 被 
子 类 化 。 所 有 的 构造 器 都 必须 显 式 或 隐 式 地 调用 
超 类 (superclass) 构造 器 ， 在 这 种 情形 下 ， 子 类 














就 没有 可 访问 的 超 类 构造 器 可 调用 了 。 


第 5 条 : 避免 创建 不 必要 
的 对 象 


一 般 来 说 ， 最 好 能 重用 对 象 而 不 是 在 每 次 需要 的 
时 候 就 创建 一 个 相同 功能 的 新 对 象 。 重 用 方式 既 
快速 ， 又 流行 。 如 果 对 象 是 不 可 变 的 
CGimmutable) 〈 见 第 15 条 ) ， 它 就 始终 可 以 被 
重用 。 


作为 一 个 极端 的 反面 例子 ， 考 虑 下 面 的 语句 : 


String s = new String( "stringette" ); 
-_ 


// DON'T DO THIS 


该 语句 每 次 被 执行 的 时 候 都 创建 一 个 新 的 string 
实例 ， 但 是 这 些 创 建 对 象 的 动作 全 都 是 不 必要 

的 。 传 递 给 string 构造 器 的 参数 (“stringette” ) 
AE string 实例 ， 功 能 方面 等 同 于 构 
造句 创建 的 所 有 对 象 。 如 果 这 种 用 法 是 在 一 个 循 
环 中 ， 或 者 是 在 一 个 被 频繁 调用 的 方法 中 ， 束 会 
创建 出 成 千 上 万 不 必要 6J String 实例 。 


改进 后 的 版 本 如 下 所 示 : 


String s = "stringette" ; 





这 个 版 本 只 用 了 一 个 string 实例 ， 而 不 是 每 次 
执行 的 时 候 都 创建 一 个 新 的 实例 。 而 且 ， 它 可 以 
保证 ， 对 于 所 有 在 同一 台 虚 拟 机 中 运行 的 代码 ， 
只 要 它们 包含 相同 的 字符 串 字 面 常 量 ， 该 对 象 就 
会 被 重用 [JLS，3.10.5]。 


对 于 同时 提供 了 静态 工厂 方法 〈 见 第 1 条 〉 和 构 
造 侣 的 不 可 变 类 ， 通 常 可 以 使 用 静态 工厂 方法 而 
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静态 工厂 方法 Boolean.valueof(String ) 几乎 总 是 优 
先 于 构造 器 Boolean(String) œ 构造 器 在 每 次 被 调 
用 的 时 候 都 会 创建 一 个 新 的 对 象 ， 而 静态 工厂 方 
法 则 从 来 不 要 求 这 样 做 ， 实 际 上 也 不 会 这 样 做 。 


除了 重用 不 可 变 的 对 象 之 外 ， 也 可 以 重用 那些 已 
知 不 会 被 修改 的 可 变 对 象 。 下 面 是 一 个 比较 微 

妙 、 也 比较 常见 的 反面 例子 ， 其 中 涉及 可 变 的 

pate 对 象 ， 它 们 的 值 一 旦 计算 出 来 之 后 就 不 再 
ABU. 这 个 天 建 证 了 一 个 模型 其 中 有 一 个 人 
并 H = isBabyBoomer 方法 ， 用 来 检验 这 个 人 是 
否 为 一 个 “baby boomer (生育 高 峰 期 出 生 的 小 

孩 )”， 换 句 话 说 ， 就 是 检验 这 个 人 是 否 出 生 于 
1946 年 至 1964 年 期 间 。 


public class Person { 


private final Date birthDate; 


// Other fields, methods, and constructor omitted 
// DON'T DO THIS ! 


public boolean isBabyBoomer () { 


// Unnecessary allocation of expensive object 
Calendar gmtCal = 


Calendar .getInstance(TimeZone.getTimeZone( 
"GMT" Ne 


gmtCal.set( 1946 , Calendar.JANUARY, i, 0 
TO O 中 


Date boomStart = gmtCal.getTime(); 


gmtCal.set( 1964 , Calendar .JANUARY, i, 0 
, 0, 0); 


Date boomEnd = gmtCal.getTime(); 


return birthDate.compareTo(boomStart) >= 0 
&& 


birthdate. compareTo(boomEnd) < OF 


isBabyBoomer 每 次 被 调用 的 时 候 ， 都 会 新 建 一 个 
Calendar 、 一 个 TimeZone 和 两 个 Date 实例 , 这 

是 不 必要 的 。 下 面 的 版 本 用 一 个 静态 的 初始 化 右 
(initializer) ， 避 免 了 这 种 效率 低下 的 情况 ; 
public class Person { 


private final Date birthDate; 


// Other fields, methods, and constructor omitted 


/** 
* The starting and ending dates of the baby boom 
*/ 

private static final Date BOOM_START; 


private static final Date BOOM_END; 


static { 
Calendar gmtCal = 


Calendar .getInstance(TimeZone.getTimeZone( 
"GMT" ye 


gmtCal.set( 1946 , Calendar.JANUARY, i, 0 
mo nO 让 


BOOM_START = gmtCal.getTime(); 


gmtCal.set( 1964 , Calendar.JANUARY, i, 0 
, 0, ©); 


BOOM_END = gmtCal.getTime(); 


public boolean isBabyBoomer () { 


return birthDate.compareTo(boomStart) >= 0 
&& 


birthdate. compareTo(boomEnd) < OF 
} 


改进 后 的 person 类 只 在 初始 化 的 时 候 创建 
Calendar 、 TimeZone 和 Date 实例 一 次 ， 而 
不 是 在 每 次 调用 isBabyBoomer 的 时 候 都 创建 
这 些 实例 。 如 果 iseabygoomer 方法 被 频 党 的 
调用 ， 这 种 方法 将 会 显 车 地 提高 性 能 。 在 我 
的 机 右上 ， 每 调用 一 千 万 次 ， 原 来 的 版 本 需 
要 32000ms， 而 改进 后 的 版 本 只 需要 
130ms， 大 约 快 乐 250 倍 。 除 了 提高 性 能 之 
外 ， 代码 的 含义 也 更 清晰 了 。 把 boomStart 
和 boomEnd 从 局 部 变量 改 为 final 静态 域 ， 
这 些 日 期 显然 是 被 作为 种 量 对 符 ， 从 而 使 得 
代码 更 易于 理解 。 但 是 ， 这 种 优化 融 来 的 效 
果 并 不 总 是 那么 明显 ， 因为 Calendar 实例 的 
创建 代价 特别 昂 贯 。 


如 果 改 进 后 的 person 类 被 初始 化 了 ， 它 的 
isBabyBoomer 方法 却 永 远 不 会 被 调用 ， Als it 
没有 必要 初始 化 Boom start 和 Boom ENp 域 。 
通过 延迟 初始 化 C lazy initializing) 〈 见 第 
71 条 ) ， 即 把 对 这 些 域 的 初始 化 延迟 到 
isBabyBoomer 方法 第 一 次 被 调用 的 时 候 进 
行 ， 则 有 可 能 消除 这 些 不 必要 的 初始 化 工 
作 ， 但 是 不 建议 这 样 做 。 正 如 延迟 初始 化 中 
常见 的 情况 一 样 ， 这 样 做 会 使 方法 的 实现 更 
加 复杂 ， 从 而 无 法 将 性 能 显著 提高 到 超过 已 
经 达到 的 水 平 〈 见 第 55 条 ) 。 


在 本 条 目前 面 的 例子 中 ， 所 讨论 到 的 对 象 显 
然 都 是 能 够 被 重用 的 ， 因 为 它们 被 初始 化 之 
后 不 会 再 改变 。 其 他 有 些 情 形 则 并 不 总 是 这 
么 明显 了 。 考 虑 适配器 (adapter) 的 情形 
[Gamma95，Pp. 139]， 有 时 也 叫做 视图 C 

view) 。 适 配器 是 指 这 样 一 个 对 象 : 它 把 功 


能 委托 给 一 个 后 备 对 象 (backing object) , 
从 而 为 后 备 对 象 提供 一 个 可 以 蔡 代 的 接口 。 
由 于 适配器 除了 后 被 对 象 之 外 ， 没 有 其 他 的 
状态 信息 ， 所 以 针对 某 个 给 定 对 象 的 特定 适 
配器 而 言 ， 它 不 需要 创建 多 个 适配器 实例 。 


例如 ， map 接口 的 keyset 方法 返回 该 map 
对 象 的 set 视图 ， 其 中 包含 该 wap 中 所 有 
的 键 (key，〉。 粗 看 起 来 ， 好 像 每 次 调用 
keyset 都 应 该 创建 一 个 新 的 set 实例 ， 但 
是 ， 对 于 一 个 给 定 的 map 对象， 实际 上 每 次 
调用 keySet 都 返回 同样 的 Set 实例 。 虽然 
被 返回 的 set 实例 一 般 是 可 改变 的 ， 但 是 所 
有 返回 的 对 象 在 功能 上 是 等 同 的 : 当 其 中 一 
个 返回 对 象 发 生变 化 的 时 候 ， 所 有 其 他 的 返 
回 对 象 也 要 发 生变 化 ， 因 为 她 们 是 由 同一 个 
map 实例 文 撑 的 。 昌 然 创 建 keyset 视图 对 
oe Peau es 却 也 是 没有 必要 


在 Java 1.5 发 行 版 本 中 ， 有 一 种 创建 多 余 对 

象 的 新 方法 ， 称 作 上 自动 装 箱 〈 autoboxing 

) ， 它 允许 程序 员 将 基本 类 型 和 装 箱 基 本 类 
型 (Boxed Primitive Type) 混用 ， 按 需要 上 自 
动 装 箱 和 拆 箱 。 自 动 装 箱 使 得 基本 类 型 和 装 
箱 基 本 类 型 之 间 的 差别 变 得 模糊 起 来 ， 但 是 
并 没有 完全 消除 。 它 们 在 语义 上 还 是 有 着 微 
妙 的 差别 ， 在 性 能 上 也 有 着 比较 明显 的 差别 
〈 见 第 49 条 ) 。 考 虑 下 面 的 程序 ， 它 计算 所 
有 int 正 值 的 总 和 。 为 此 ， 程 序 必 须 使 用 

long 算法 ， 因 为 it 不 够 大 ， 无 法 容纳 所 
有 int 正 值 的 总 和 : 








// Hideously slow program! Can you spot the object creation? 
public static void main (String[] args) 
Long sum = 0 ; 


for (long i= 0 


; i < Integer.MAX_VALUE; i++) { 
sum += i; 
} 


System.out.printin(sum); 


} 


这 段 程 序 算 出 的 答案 是 正确 的 ， 但 是 比 实际 
情况 要 更 慢 一 些 ， 只 因为 打 错 了 一 个 字 
符 。 变量 Sum 被 声明 成 Long 而 不 是 long » 
意味 着 程序 构造 了 大 约 $$2^{31}$$ 个 多 余 的 
Long 实例 (大 约 每 次 往 Long sum 中 增加 
tong 时 构造 一 个 实例 ) 。 将 sum 的 声明 从 
Long 改 成 long ， 在 我 的 机 右上 使 运行 时 间 
从 43 秒 减少 到 了 6.8 秒 。 结 论 很 明显 : 要 优 
先 使 用 基本 类 型 而 不 是 装 箱 基 本 类 型 ， 要 当 
心 无 意识 的 自动 装 箱 。 


不 要 错误 地 认为 本 条 目 所 介绍 的 内 容 瞳 示 
者 “创建 对 象 的 代价 非常 昂贵 ， 我 们 应 该 要 
尽 可 能 地 避免 创建 对 象 ?。 相 反 ， 由 于 小 对 
象 的 构造 器 只 做 很 少量 的 显 式 工作 ， 所 以 ， 
小 对 象 的 创建 和 回收 动作 是 非常 廉价 的 ， 特 
别 是 在 现代 的 JVM 实 现 上 更 是 如 此 。 通 过 创 
建 附 加 的 对 象 ， 提 升 程序 的 清晰 性 、 简 洁 性 
和 功能 性 ， 这 通常 是 件 好 事 。 


有 反之， 通过 维护 自己 的 对 象 池 C object pool 
) 来 避免 创建 对 象 并 不 是 一 种 好 的 做 法 ， 除 
非 池 中 的 对 象 是 非常 重量 级 的 。 真 正 正确 使 
用 对 象 池 的 典型 正确 示例 就 是 数据 库 连 接 
池 。 建 立 数 据 库 连接 的 代价 是 非常 昂贵 的 ， 
因此 重用 这 些 对 象 非常 有 意义 。 而 且 ， 数 据 
库 的 许可 可 能 限制 你 只 能 使 用 一 定数 量 的 连 
接 。 但 是 ， 一 般 而 言 ， 维 护 自己 的 对 象 池 必 
定 会 把 代码 乔 得 很 乱 ， 同 时 增加 内 存 占 用 
(footprint) ， 并 且 还 会 损害 性 能 。 现 代 的 





























JVM 实 现 具有 高 度 优化 的 垃圾 回收 费 ， 其 性 
能 很 容易 就 会 超过 轻 量 级 对 象 池 的 性 能 。 


与 本 条 目 对 应 的 是 第 39 条 中 有 关 “ 保护 性 撕 
由 ( defensive copying ) ”的 内 容 。 本 条 目 提 
及 “ 当 你 应 该 重用 现 有 对 象 的 时 候 ， 请 不 要 
创建 新 的 对 象 ?， 而 第 39 条 则 说 “ 当 你 应 该 创 
建新 对 象 的 时 候 ， 请 不 要 重用 现 有 对 象 ”。 
注意 ， 在 提倡 使 用 保护 性 拷贝 的 时 候 ， 因 为 
重用 对 象 要 付出 的 代价 要 远 远 大 于 因 创建 重 
复 对 象 而 付出 的 代价 。 必 要 时 如 果 没 能 实施 
保护 性 拷贝 ， 将 会 导致 潜在 的 错误 和 安全 漏 
W: 而 不 必要 的 创建 对 象 则 只 会 影响 程序 的 
风格 和 性 能 。 


第 6 条 : 消除 过 期 的 对 
象 引用 


当 你 从 手工 管理 内 存 的 语言 《比如 C 或 
C++) 转换 到 具有 垃圾 回收 功能 的 的 语言 的 
时 候 ， 程 序 员 的 工作 会 变 得 更 加 容易 ， 因 为 
当 你 用 完了 对 象 之 后 ， 它 们 会 被 自动 回收 。 
当 你 第 一 次 经 历 对 象 回 收 功 能 的 时 候 ， 会 沉 
得 这 简直 有 点 不 可 思议 。 这 很 容易 给 你 留 下 
这 样 的 印象 ， 认 为 目 己 不 再 需要 考虑 内 存 管 
理 的 事情 了 。 其 实 不 然 。 


考虑 下 面 这 个 简单 的 栈 实现 的 例子 : 


// Can you spot the "memory leak"? 











public class Stack { 
private Object[] elements; 
private int size= 0; 


private static final int 
DEFAULT_INITIAL_CAPACITY = 16 ; 


public Stack () { 


elements = new 
Object [DEFAULT_INITIAL_CAPACITY]; 


} 


public void push (Object e) { 
ensureCapacity(); 


elements[size++] = e; 


public Object pop () £ 
if (size == 0) 


throw new 
EmptyStackException(); 


return elements[--size]; 


/** 
* Ensure space for at least one more element, roughly 
* doubling the capacity each time the array needs to grow. 
27 
private void ensureCapacity () { 

if (elements.length == size) 


elements = Arrays .copay0f (elements, 
2 k size 1); 


} 


这 上 段 程序 ( 它 的 泛 型 版 本 请 见 第 26 条 ) 
中 并 没有 很 明显 的 错误 。 无 论 如 何 测 
试 ， 它 都 会 成 功 地 通过 每 一 项 测试 ， 但 
这 个 程序 中 隐藏 着 一 个 问题 。 不 严格 
地 讲 ， 这 段 程序 有 一 个 < 内 存 泄露 "， 随 if 





着 垃圾 回收 器 活动 的 增加 ， 或 者 由 于 内 
存 占用 的 不 断 增加 ， 程 序 性 能 的 降低 会 
逐渐 表现 出 来 。 在 极端 的 情况 下 ， 这 种 
内 存 泄露 会 导致 磁盘 交换 〈Disk 
Paging) ， 甚 至 导致 程序 失败 ( 
OutOfMemoryError 错误 ) ’ 但 是 这 种 失败 
情形 相对 比较 少见 。 


那么 ， 程 序 中 哪里 友 生 了 内 存 泄露 呢 ? 
如 果 一 个 栈 先 是 增长 ， 然 后 再 收缩 ， 那 
么 ， 从 栈 中 弹出 来 的 对 象 将 不 会 被 当做 
垃圾 回收 ， 即 使 使 用 栈 的 程序 不 再 引用 
这 些 对 象 ， 它 们 也 不 会 被 回收 。 这 是 因 
为 ， 栈 内 部 维护 着 对 这 些 对 象 的 过 期 引 
用 (obsolete reference) 。 所 谓 的 过 期 
引用 ， 是 指 永远 也 不 会 再 被 解除 的 引 
Ho 在 本 例 中 ， 凡是 在 elements 数组 
的 “活动 部 分 ”(active portion) 之 外 的 
任何 引用 都 是 过 期 的 。 活 动 部 分 是 指 
elements 中 下 标 小 于 size 的 那些 元 


FIN o 


在 文 持 垃圾 回收 的 语言 中 ， 内 存 泄露 是 
很 隐蔽 的 ( 称 这 类 内 存 泄露 为 “ 无 意识 
的 对 象 保持 (unintentional object 

retention) ”更 为 恰当 ) 。 如 果 一 个 对 象 
引用 被 无 意识 地 保留 起 来 了 ， 那 么 ， 垃 
圾 回收 机 制 不 仅 不 会 处 理 这 个 对 象 ， 而 
且 也 不 会 处 理 被 这 个 对 象 所 引用 的 所 有 
其 他 对 象 。 即 使 只 有 少量 的 几 个 对 象 引 
用 被 无 意识 地 保留 下 来 ， 也 会 有 许 许多 
多 的 对 象 被 排除 在 垃圾 回收 机 制 之 外 ， 
从 而 对 性 能 造成 潜在 的 重大 影响 。 


这 类 问题 的 修复 方法 很 简单 : 一旦 对 象 
引用 已 经 过 期 ， 只 需 清空 这 些 引 用 即 
可 。 对 于 上 述 例子 中 的 Stack 类 而 言 ， 
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要 一 个 单元 被 弹出 栈 ， 指 网 它 的 引用 
过 期 了 。 pop 方法 的 修订 版 本 如 下 所 
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public Object pop () { 
if (size == 0 ) 


throw new 
EmptyStackException(); 


Object result = elements[--size]; 


elements[size] = null ; 
// Eliminate obsolete reference 


return result; 


清空 过 期 引用 的 男 一 个 好 处 是 ， 如 果 它 
们 以 后 又 被 错误 地 解除 引用 ， 程 序 融会 
立即 抛 出 NullPointerException 异常 ， 而 
不 是 悄悄 地 错误 运行 下 去 。 尽 快 地 检测 
出 程序 中 的 错误 总 是 有 益 的 。 


当 程序 员 第 一 次 被 类 似 这 样 的 问题 困扰 
的 时 候 ， 他 们 往往 会 过 分 小 心 : 对 于 每 
一 个 对 象 引 用 ， 一旦 程序 不 再 用 到 它 ， 
就 把 它 清空 。 其 实 这 样 做 既 没 必要 ， 也 
不 是 我 们 所 期 望 的 ， 因 为 这 样 做 会 把 程 
序 代 码 弄 得 很 乱 。 清空 对 象 引用 应 该 是 
一 种 例外 ， 而 不 是 一 种 规范 行为 。 消 
除 过 期 引用 最 好 的 方法 是 让 包含 该 引用 
的 变量 结束 其 生命 周期 。 如 果 你 是 在 最 
紧凑 的 作用 域 范围 内 定义 每 一 个 变量 
( 见 第 45 条 )〉 ， 这 种 情形 就 会 目 然而 然 
地 发 生 。 


那么 ， 何 时 应 该 清空 引用 呢 ? Stack 类 
的 哪 方面 特性 使 它 易 于 遭受 内 存 泄露 的 
影响 呢 ? 人 简 而 言 之 ， 问 题 在 于 ， stack 
类 自己 管理 内 存 (manage its own 














memory) . 存储 池 (storage pool) 包 
ame elements 数组 (对 象 引 用 单元 ， 而 
不 是 对 象 本 喘 ) 的 元 素 。 数 组 活动 区 域 
( 同 前 面 的 定义 〉 中 的 元 素 是 已 分 配 的 
(allocated) ， 而 数组 其 余部 分 的 元 素 
则 是 自由 的 Cfree) 。 但 是 垃圾 回收 器 
并 不 知道 这 一 点 ;对 于 垃圾 回收 器 而 

a elements 数组 中 的 所 有 对 象 引 用 都 
同等 有 效 。 只 有 程序 员 知 道 数组 的 非 活 
动 部 分 是 不 重要 的 。 程 序 员 可 以 把 这 个 
情况 告知 垃圾 回收 器， 做 法 很 简单 : 一 
旦 数组 元 素 变 成 了 非 活 动 部 分 的 一 部 

分 ， 程 序 员 就 手工 清空 这 些 数组 元 素 。 


一 般 而 言 ， 只 要 类 是 自己 管理 内 存 ， 程 
序 员 就 应 该 警惕 内 存 泄 圳 问题 。 一 旦 
元 素 被 释放 掉 ， 则 该 元 素 中 包含 的 任何 
对 象 引用 都 应 该 被 清空 。 


内 存 泄 露 的 另 一 个 种 见 来 源 是 缓存 o 

一 且 你 把 对 象 引 用 放 到 缓存 中 ， 它 就 很 
容易 被 遗忘 控 ， 从 而 使 得 它 不 再 有 用 之 
后 很 长 一 段 时 间 内 仍然 留 在 绥 存 中 。 对 
于 这 个 问题 ， 有 几 种 可 能 的 解决 方案 。 
如 果 你 正好 要 实现 这 样 的 缓存 ， 只 要 在 
缓存 之 外 存在 对 茶 个 项 的 键 的 引用 ， 访 
MARX, 那么 就 可 以 用 WeakHashMap 
代表 缓存 ， 当 绥 存 中 的 项 过 期 后 ， 它 们 
就 会 自动 被 删除 。 记 住 只 有 当 所 要 的 组 
存 项 的 生命 周期 是 由 该 键 的 外 部 引用 而 
ene WeakHashMap 才 有 用 





























更 为 第 见 的 情形 则 是 ，“ 缓 存 项 的 生命 
周期 是 否 有 意义 ”并 不 是 很 容易 确定 ， 

随 痢 时 间 的 推移 ， 其 中 的 项 会 变 得 越 来 
越 没 有 价值 。 在 这 种 情况 下 ， 绥 存 应 该 














时 不 时 地 清除 掉 没 用 的 项 。 这 项 清除 工 
作 可 以 由 一 个 后 台 线 程 (可 能 是 Timer 
或 者 ScheduledThreadPoolExecutor ) 来 完 
成 ， 或 者 也 可 以 在 给 缓存 添加 新 条 目的 
时 候 顺 便 进行 清理 。 LinkedHashmap 类 利 
用 它 的 removeEldestEntry 可 以 很 容易 地 实 
现 后 一 种 方案 。 对 于 更 加 复杂 的 缓存 ， 
必须 直接 使 用 java.lang.ref o 


内 存 泄露 的 第 三 个 常见 来 源 是 监听 器 和 
其 他 回调 。 如 果 你 实现 了 一 个 API， 客 
户 端 在 这 个 API 中 注册 回调 ， 却 没有 显 
式 地 取消 注册 ， 那 么 除非 你 采取 菜 些 动 
作 ， 人 否则 它们 融会 积聚 。 确 保 回调 立即 
被 当做 垃圾 回收 的 最 佳 方法 是 只 保存 它 
们 的 弱 引 用 (weak reference) ， 例 

“4 只 将 它们 保存 成 weakHashmap 中 的 








由 于 内 存 泄露 通常 不 会 表现 成 明显 的 失 
败 ， 所 以 它们 可 以 在 一 个 系统 中 存在 很 
多 年 。 往 往 只 有 通过 仔细 检查 代码 ， 或 
{i Hit Heap tL (Heap 
Profiler) 才能 发 现 内 存 汇 漏 问 题 。 
DE, UR REITE N itis AE At AM 
道 如 何 预测 此 类 问题 ， 并 阻止 它们 发 
生 ， 那 是 最 好 不 过 的 了 。 


第 7 条 : 避免 使 用 终 
结 方法 


终结 方法 (finalizer〉 通常 是 不 可 预测 
的 ， 也 是 很 危险 的 ， 一 般 情况 下 是 不 必 
要 的 。 使 用 终结 方法 会 导致 行为 不 稳 
定 、 降 低 性 能 ， 以 及 可 移植 性 问题 。 当 
然 ， 终 结 方法 也 有 其 可 用 之 处 ， 我 们 将 











在 本 条 目的 最 后 再 做 介绍 ; 但 是 根据 经 
验 ， 应 该 避免 使 用 终结 方法 。 


C++ 的 程序 员 被 告知 “不 要 把 终结 方法 
当 作 是 C++ 中 的 析 构 器 〈destructor) 的 
对 应 物 ”。 在 C++ 中 ， 析 构 器 是 回收 一 
个 对 象 所 占用 资源 的 常规 方法 ， 是 构造 
器 所 必需 的 对 应 物 。 在 Java 中 ， 当 一 个 
对 象 变 得 不 可 到 达 的 时 候 ， 垃 圾 回收 占 
会 回收 与 该 对 象 相关 联 的 存储 空间 ， 并 
不 需要 程序 员 做 专门 的 工作 。C++ 的 析 
构 器 也 可 以 被 用 来 回收 其 他 的 非 内 存 资 
源 。 而 在 Java 中 ， 一 般 用 try-finally 块 来 
完成 类 似 的 工作 。 


终结 方法 的 缺点 在 于 不 能 保证 会 被 及 时 
地 执行 [JLS，12.6]。 从 一 个 对 象 变 得 不 
可 到 达 开 始 ， 到 它 的 终结 方法 被 执行 ， 
所 花费 的 这 段 时 间 是 任意 长 的 。 这 意味 
着 ， 注 重 时 间 (time-critical〉 的 任务 不 
应 该 由 终结 方法 来 完成 。 例 如 ， 用 终结 
方法 来 关闭 已 经 打 开 的 文件 ， 这 是 严重 
错误 ， 因 为 打开 文件 的 描述 符 是 一 种 很 
有 限 的 资源 。 由 于 JVM 会 延迟 执行 终结 
方法 ， 所 以 大 量 的 文件 会 保留 在 打开 状 
态 ， 当 一 个 程序 再 不 能 打开 文件 的 时 

候 ， 它 可 能 会 运行 失败 。 


及 时 地 执行 终结 方法 正 是 垃圾 回收 算法 
的 一 个 主要 功能 ， 这 种 算法 在 不 同 的 
JVM 实 现 中 会 大 相 径 姓 。 如 果 程 序 依 赖 
于 终结 方法 被 执行 的 时 间 点 ， 那 么 这 个 
程序 的 行为 在 不 同 的 VM 中 运行 的 表现 
可 能 就 会 截然 不 同 。 一 个 程序 在 你 测试 
用 的 JVM 平 台 上 运行 得 非常 好 ， 而 在 你 
最 重要 顾客 的 JVM 平 台 上 却 根本 无 法 运 
行 ， 这 是 完全 有 可 能 的 。 

















延迟 终结 过 程 并 不 只 是 一 个 理论 问题 。 
在 很 少见 的 情况 下 ， 为 类 提供 终结 方 

法 ， 可 能 会 随意 地 延 到 其 实例 的 回收 过 
程 。 一 位 同事 最 近 在 调试 一 个 长 期 运行 
的 GUI 应 用 程序 的 时 候 ， 该 应 用 程序 莫 
名 其 妙 地 出 现 OutOfMemoryError 错误 而 死 
掉 。 分 析 表 明 ， 该 应 用 程序 死 掉 的 时 

候 ， 其 终结 方法 队列 中 有 数 千 个 图 形 对 
象 正在 等 和 被 终结 和 回收 。 遗 憾 的 是 ， 

终结 方法 线程 的 优先 级 比 该 应 用 程序 的 
其 他 线程 要 低 得 多 ， 所 以 ， 图 形 对 象 的 
终结 速度 达 不 到 它们 进入 队列 的 速度 。 
Java 语 言 规范 并 不 保证 哪个 线程 将 会 执 
行 终结 方法 ， 所 以 ， 除 了 不 使 用 终结 方 
法 之 外 ， 并 没有 很 轻便 的 方法 能 够 避免 
这 样 的 问题 。 


Java 语 言 规范 不 仅 不 保证 终结 方法 会 被 
及 时 地 执行 ， 而 且 根本 惑 不 保证 它们 会 
被 执行 。 当 一 个 程序 终止 的 时 候 ， 某 些 
己 经 无 法 访问 的 对 象 上 的 终结 方法 却 根 
本 没有 被 执行 ， 这 是 完全 有 可 能 的 。 结 
论 是 : 不 应 该 依赖 终结 方法 来 更 新 重要 
的 持久 状态 。 例 如 ， 依 赖 终结 方法 来 
释放 共有 至 资源 (比如 数据 库 ) 上 的 永久 
锁 ， 很 容易 让 整个 分 布 式 系 统 垮 挥 。 














不 要 被 System, gc 和 System.runFinalization 
这 两 个 方法 所 诱惑 ， 它 们 确实 增加 了 终 
结 方法 被 执行 的 机 会 ， 但 是 它们 并 不 保 
证 终结 方法 一 定 会 被 执行 。 唯 一 保证 终 
结 方法 被 执行 的 方法 是 
System.runFinalizersOnExit ， 以 及 它 具 名 
HS = AYE AE 
Runtime.runFinalizersOnExit o 这 两 个 方法 
都 有 致命 的 缺陷 ， 己 经 被 废 莽 了 
[ThreadStop]。 


当 你 并 不 确定 是 否 应 该 避免 使 用 终结 方 
法 的 时 候 ， 这 里 还 有 一 种 值得 考虑 的 情 
We: 如 果 未 捕获 的 异常 在 终结 过 程 中 被 
抛 出 来 ， 那 么 这 种 异常 可 以 被 忽略 ， 并 
且 该 对象 的 终结 过 程 也 会 被 终止 [JLS， 
12.6]。 未 捕获 的 异常 会 使 对 象 处 于 破坏 
的 状态 (a corrupt state) ， 如 果 另 一 个 
线程 企图 使 用 这 种 被 破坏 的 对 象 ， 则 可 
能 发 生 任何 不 确定 的 行为 。 正 常情 况 

下 ， 未 捕获 的 异常 将 会 使 线程 终止 ， 并 
打印 出 栈 轨迹 〈Stack Trace) ， 但 是 ， 

如 果 异 常 发生 在 终结 方法 之 中 ， 则 不 会 
如 此 ， 甚 至 连 警告 都 不 会 打印 出 来 。 


还 有 一 点 : 使 用 终结 方法 有 一 个 非常 严 
FEY) (Severe) 性 能 损失 。 在 我 的 机 器 
上 ， 创 建 和 销毁 一 个 简单 对 象 的 时 间 大 
约 为 5.6ns。 增 加 一 个 终结 方法 使 时 间 增 
加 到 了 2400ns。 换 句 话 说 ， 用 终结 方法 
创建 和 销毁 对 象 慢 了 大 约 430 倍 。 


那么 ， 如 末 类 的 对 象 中 封装 的 资源 〈 例 
如 文件 或 者 线程 ) 确实 需要 终止 ， 应 该 
怎么 做 才能 不 用 编写 终 络 方 法 呢 ? 只 需 
提供 一 个 显 式 的 终结 方法 ， 并 要 求 该 

类 的 客户 端 在 每 个 实例 不 再 有 用 的 时 候 
调用 这 个 方法 。 值 得 提 及 的 一 个 细节 

是 ， 该 实例 必须 记录 下 目 己 是 否 已 经 被 
终止 了 : 显 式 的 终止 方法 必须 在 一 个 私 
有 域 中 记录 下 “该 对 象 已 经 不 再 有 效 ”。 

如 果 这 些 方法 是 在 对 象 已 经 终止 以 后 被 
调用 ， 其 他 的 方法 束 必 须 检 查 这 个 域 ， 


并 抛 出 IllegalStateException 异常 。 


显 式 终止 方法 的 典型 例子 是 tnputstream 
OutputStream 和 java.sql.Connection 上 


的 close Ts P= ee 

















java.util.Timer 上 的 cancel 方法 ， EH 
行 必要 的 状态 改变 ， 使 得 与 Timer 实例 
相关 联 的 该 线程 温和 地 终止 自己 。 
java.awt 中 的 例子 还 包括 
Graphics.dispose 和 Window.dispose o 这 些 
方法 由 于 性 能 不 好 而 不 被 人 们 关注 。 一 
个 相关 的 方法 是 Image.flush  ， 它 会 释放 
所 有 与 image 实例 相关 联 的 资源 ， 但 是 
该 实例 仍然 处 于 可 用 的 状态 ， 有 过 有 必 
要 的 话 ， 会 重新 分 配 资源 。 


显 式 的 终止 方法 通常 与 try-rinaly 结 
构 结合 起 来 使 用 ， 以 确保 及 时 终止 。 
在 finally 子 句 内 部 调用 显 式 的 终止 方 
法 ， 可 以 保证 即使 在 使 用 对 象 的 时 候 有 
异常 抛 出 ， 该 终止 方法 也 会 执行 : 
// try- 
finally block guarantees execution of termination methods 


Foo foo = new Foo(...); 


try Re 


// Do what must be done with foo 


} finally { 


foo.terminate(); 
// Explicit termination method 


} 


那么 终结 方法 有 什么 好 处 呢 ? 它们 有 两 
种 合法 用 途 。 第 一 种 用 途 是 ， 当 对 象 的 
所 有 者 忘记 调用 前 面 段落 中 建议 的 显 式 
终止 方法 时 ， 终 结 方法 可 以 充当 “安全 

网 (safety net) ”。 虽然 这 样 做 并 不 能 

保证 终结 方法 会 被 及 时 地 调用 ， 但 是 在 
客户 端 无 法 通过 调用 显 式 的 终止 方法 来 
正常 结束 操作 的 情况 下 (希望 这 种 情形 
尽 可 能 地 少 发 生 ) ， 述 一 点 释放 关键 资 








源 总 比 永远 不 释放 要 好 。 但 是 如 果 终 结 
方法 发 现 资源 还 未 被 终止 ， 则 应 该 在 日 
志 中 记录 一 条 警告 ， 因 为 这 表示 客户 
端 代码 中 的 一 个 Bug， 应 该 得 到 修复 。 
如 果 你 正 考 虑 编写 这 样 的 安全 网 终结 方 
法 ， 就 要 认真 考 碟 清楚 ， 这 种 额外 的 保 
护 是 否 值 得 你 付出 这 份额 外 的 代价 。 


显 式 终止 方法 模式 的 示例 中 所 示 的 四 各 
类 ( FileInputStream 、 FileOutputStream 

Timer 和 Connection ) , MARA 
方法 ， 当 它们 的 终止 方法 未 能 被 调用 的 
情况 下 ， 这 些 终结 方法 充当 了 安全 网 。 


终结 方法 的 第 二 种 合理 用 途 与 对 象 的 本 
地 对 等 体 (native peer) 有 关 。 本 地 对 
等 体 是 一 个 本 地 对 象 Cnative object) ， 
普通 对 象 通过 本 地 方法 (native 
method) 委托 给 一 个 本 地 对 象 。 因 为 本 
地 对 等 体 不 是 一 个 普通 对 象 ， 所 以 垃圾 
回收 器 不 会 知道 它 ， 当 它 的 Java 对 等 体 
被 回收 的 时 候 ， 它 不 会 被 回收 。 在 本 地 
对 等 体 并 不 拥有 关键 资源 的 前 提 下 ， 终 
结 方法 正 是 执行 这 项 任务 最 合适 的 工 
上 只。 如 有 果 本 地 对 等 体 拥有 必须 被 及 时 终 
止 的 资源 ， 那 么 该 类 就 应 该 具有 一 个 显 
式 的 终止 方法 ， 如 前 所 述 。 终 止 方法 应 
该 完成 所 有 必要 的 工作 以 便 释 放 关 键 的 
资源 。 终 止 方法 可 以 是 本 地 方法 ， 或 者 
它 也 可 以 调用 本 地 方法 。 


值得 注意 的 很 重要 一 点 是 ，“ 终 结 方法 
链 (finalizer chaining) ”并 不 会 被 自动 
执行 。 如 果 类 Cae Object ) 有 终结 方 
法 ， 并 且 子 类 和 窗 新 了 终结 方法 ， 子 类 的 
终结 方法 就 必须 手工 调用 超 类 的 终结 方 
法 。 你 应 该 在 一 个 try 块 中 终结 子 类 ， 并 




















在 相应 的 finally 块 中 调用 超 类 的 终结 方 
法 。 这 样 做 可 以 保证 ， 即 使 子 类 的 终结 
过 程 抛 出 异常 ， 超 类 的 终结 方法 也 会 得 
到 执行 。 反 之 亦 然 。 代 码 示例 如 下 。 注 
意 这 个 示例 使 用 了 Override 注解 ( 
@Override ) , 这 是 Java 1.5 发 新 版 本 将 
它 增加 到 Java 平 台中 的 。 你 现在 可 以 不 
管 Override 注解 ， 或 者 到 第 36 条 查阅 一 
下 它们 表示 什么 意思 : 


// Manual finalizer chaining 


@Override protected void finalize () 
throws Throwable { 


try W 
. // Finalize subclass state 
} finally E 


super .finalize(); 


WR PAR SW m SEBRING 
7, (AAS SFL BARNA TIE 
(或 者 有 意 选 择 不 调用 超 类 的 终结 方 
法 ) ， 那 么 超 类 的 终结 方法 将 永远 也 不 
会 被 调用 到 。 要 防范 这 样 粗 心 大 意 或 者 
恶意 的 子 类 是 有 可 能 的 ， 代 价 就 是 为 每 
个 将 要 终 被 的 对 象 创 建 一 个 附加 的 对 
象 。 不 是 把 终结 方法 放 在 要 求 终结 处 理 
的 类 中 ， 而 是 把 终结 方法 放 在 一 个 匿名 
的 类 《〈 见 第 22 条 ) 中 ， 访 匿名 类 的 唯一 
作用 就 是 终结 它 的 外 围 实例 (enclosing 
instance) 。 访 匿名 类 的 单个 实例 被 称 
为 终结 方法 守卫 者 (finalizer 
guardian) ， 外 围 类 的 每 个 实例 都 会 创 
建 这 样 一 个 守卫 者 。 外 围 实 例 在 它 的 私 
有 实例 域 中 保存 着 一 个 对 其 终结 方法 守 











卫 者 的 唯一 引用 ， 因 此 终结 方法 守卫 者 
与 外 围 实例 可 以 同时 局 动 终结 过 程 。 当 
守卫 者 被 终结 的 时 候 ， 它 执行 外 围 实例 
所 期 望 的 终结 行为 ， 就 好 像 它 的 终结 方 
法 是 外 围 对 象 上 的 一 个 方法 一 样 : 


// Finalizer Guardian idiom 


public class Foo { 


// Sole purpose of this object is to finalize outer Foo object 


pricate final 
Object finalizerGuardian = new 
Object() { 


@Override protected void 
finalize () throws Throwable { 


// Finalize outer Foo object 


} 


// Remainder omitted 


注意 ， 公 有 类 Fo。 并 没有 终结 方法 〈 除 
SEM object 中 继承 了 一 个 无 关 紧 要 
的 之 外 ) ， 所 以 子 类 的 终结 方法 是 否 调 
用 super. finalize 并 不 重要 。 对 于 每 一 个 
带 有 终结 方法 的 非 final 公有 类 ， 都 应 
该 考虑 使 用 这 种 方法 。 


总 之 ， 除 非 是 作为 安全 网 ， 或 者 是 为 了 
终止 非 关 键 的 本 地 资源 ， 否 则 请 不 要 使 
用 终结 方法 。 在 这 些 很 少见 的 情况 下 ， 

既然 使 用 了 终结 方法 ， 就 要 记 住 调用 

super.finalize > 如 果 终 结 方法 作为 安全 
网 ， 要 记得 记录 终结 方法 的 非法 用 法 。 
最 后 ， 如 果 需 要 把 终结 方法 与 公有 的 非 
final 类 关联 起 来 ， 请 考虑 使 用 终结 方 








法 守卫 者 ， 以 确保 即使 子 类 的 终结 方法 
未 能 调用 super.finalize ， 该 终结 方法 也 
会 被 执行 。 


第 三 章 对 于 所 有 对 
象 都 通用 的 方法 


尽管 object 是 二 外 具体 闫 ;但 是 估计 
它 主要 是 为 了 扩展 。 它 所 有 的 非 final 
方法 ¢ equals \ hashCode 、 toString 、 
clone 和 finalize ) 都 有 明确 的 3 通用 约 
3 (general contract) ， 因 为 它们 被 设 
计 成 是 要 被 覆盖 〈override) 的 。 任 何 
一 个 类 ， 它 在 覆盖 这 些 方法 的 时 候 ， 都 
有 员 任 遵守 这 些 通用 约定 ;如果 不 能 做 
到 这 一 点 ， 其 他 依赖 于 这 些 约定 的 类 
(例如 HashMap 和 HashSet ) MEEA 
该 类 一 起 正 向 运作 。 


本 章 将 讲述 何 时 以 及 如 何 履 盖 这 些 非 
final 的 Object 方法 。 本 章 不 再 讨论 
finalize 方法 ， 因 为 第 7 条 已 经 讨论 过 
ATA Ss 而 Comparable.compareTo 虽 
然 不 是 object 的 方法 ， 但 是 本 章 也 对 
它 进行 讨论 ， 因 为 它 具 有 类 似 的 特征 。 











第 8 条 : 7 itt equals AS a ee TAHA 
定 


(iii, equals 方法 看 起 来 很 简单 ， 但 是 有 许多 上 履 兰 方式 会 导致 错误 ， 并 
且 后 果 非 党 严重 。 最 容易 避免 这 类 问题 的 办 法 就 是 不 履 闸 equals 方 
法 ， 在 这 种 情况 下 ， 类 的 每 个 实例 都 只 与 它 目 身 相 等 。 如 果 满 足 了 以 下 
任何 一 个 条 件 ， 这 束 正 是 所 期 望 的 结果 : 


© 类 的 每 个 实例 本 质 上 都 是 唯一 的 。 对 于 代表 活动 实体 而 不 是 值 
(value) 的 类 来 说 确实 如 此 。 例如 Thread o Object 提供 的 equals 
实现 对 于 这 些 类 来 说 正 是 正确 的 行为 。 

© 不 关心 类 是 否 提供 了 “逻辑 相等 〈logical equality) ”的 测试 功能 。 
例如 ， java.util.Random ja S equals +; 以 检查 两 个 Random 实例 是 
侍 产 生 相同 的 随机 数 序列 ， 但 是 设计 者 并 不 认为 客户 端 需 要 或 者 期 
望 这 样 的 功能 。 在 这 样 的 情况 下 ， 从 object 继承 得 到 的 equals SE 
现 已 经 足够 了 。 

° EENE equals ; 从 超 类 继承 过 来 的 的 行为 对 于 子 类 也 是 

合适 的 o 例如 ， 大 多 数 的 Set 实现 都 从 AbstractSet 继承 equals 实 

现 ， List 实现 从 AbstractList 继承 equals 实现 ， Map 实现 从 

AbstractMap 继承 equals 实现 。 

类 是 私有 的 或 是 包 级 私有 的 ， 可 以 确定 它 的 equals 方法 永远 也 不 

会 被 调用 。 在 这 种 情况 下 ， 无 疑 是 应 该 覆盖 equals 方法 的 ， 以 防 

它 被 意外 调用 : 


@Override public boolean equals (Object o) { 


























throw new AssertionError(); // Method is never called 


} 








ABA, TAMIR IAB th. object.equals W? 如 果 类 具有 目 己 特有 的 “ 馆 辑 
相等 "概念 〈 不 同 于 对 象 等 同 的 概念 ) ， 而 且 超 类 还 没有 履 六 equais 以 
实现 期 望 的 行为 ， 这 时 我 们 就 需要 履 英 equals 方法 。 这 通常 属于 “ 值 类 
(value class) ”的 情形 。 值 类 仅仅 是 一 个 表示 值 的 类 ， 例 如 integer 或 
者 pate 。 程 序 员 在 利用 equals 方法 来 比较 值 对 象 的 引用 时 ， 希 望 知道 
它们 在 馆 辑 上 是 人 否 相 等 ， 而 不 是 想 了 解 它们 是 人 否 指 回 同 一 个 对 象 。 为 了 











满足 程序 员 的 要 求 ， 不 仅 必需 履 羡 equals 方法 ， 而 且 这 样 做 也 使 得 这 
个 类 的 实例 可 以 被 用 作 映 射 表 (map) 的 键 Cey), RERE Cet) 
的 元 率 ， 使 映射 或 者 集合 表现 出 预期 的 行为 。 


A FABER AS i EB tt equals 方法 ， 即 用 实例 受 控 〈 见 第 1 条 ) 确 
保 “ 每 个 值 至 多 只 存在 一 个 对 象 ” 的 类 。 枚 举 类 型 〈 见 第 30 条 ) 就 属于 这 
种 类 。 对 于 这 样 的 类 而 言 ， 风 辑 相同 与 对 象 等 同 是 一 回 事 ， 因 此 object 
的 equals 方法 等 同 于 逻辑 意义 上 的 equals 万 上 5 


TEs tt equals 方法 的 时 候 ， 你 必须 要 遵守 它 的 通用 约定 。 下 面 是 约定 
的 内 容 ， 来 自 object 的 规范 [JavaSE6]: 


equals 方法 实现 了 EMRA (equivalence relation) : 


e HRE (reflexive) 。 对 于 任何 非 mu 的 引用 值 x ， x.equals(x) 
必须 返回 true 。 

。 对称 性 (symmetric) 。 对 于 任何 非 nu 的 引用 值 x 和 y , 4 
HAX y.equals(x) 返回 true 时 ， x.equals(y) 必须 返回 true o 

e EVE (transitive) 。 对 于 任何 非 mu 的 引用 值 x . y 和 > 
o 如 果 x.equals(y) 返回 true ， 并 且 y.equals(z) 也 返回 true ， 那 . 
x.equals(z) 也 必须 返回 true o 

e 一 致 性 〈consistent) 。 对 于 任何 非 nu 的 引用 值 x 和 y, KZ 
suals 的 比较 操作 在 对 象 中 所 用 的 信息 没有 被 修改 ， 多 次 调用 
x.equals(x) 就 会 一 致 地 返回 true ， 或 者 一 致 的 返回 faise 。 

@ 对 于 任何 非 null 的 引用 值 x 3 x.equals(null) 必须 返回 false o 
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惧 ， 但 是 绝对 不 要 忽视 这 些 规定 ! 如 果 你 违反 了 它们 ， 束 会 发 现 你 的 程 
序 将 会 表现 不 正常 ， 甚 至 崩 沉 ， 而 且 很 难 找到 失败 的 根源 。 用 John 
Donne 的 话说 ， 没 有 哪个 类 是 孤立 的 。 一 个 类 的 实例 通常 会 被 频繁 地 传 
递 给 另 一 个 类 的 实例 。 有 许多 类 ， 包 括 所 有 的 集合 类 (collection class) 
在 内 ， 都 依赖 于 传递 给 它们 的 对 象 是 否 遵 守 了 equals 约定 。 


现在 你 已 经 知道 了 违反 equals 约定 有 多 么 可 怕 ， 现 在 我 们 就 来 更 细致 
地 讨论 这 些 约 定 。 值 得 欣慰 的 是 ， 这 些 约定 虽然 看 起 来 很 中 人 ， 实 际 上 
并 不 十 分 复杂 。 一 旦 理解 了 这 些 约定 ， 要 遵守 它们 并 不 困难 。 现 在 我 们 
按照 顺序 逐一 查看 以 下 5 个 要 求 : 




















自 反 性 (reflexive) ee ols 
身 。 很 难 想象 会 无 意识 地 违反 这 一 条 。 加 入 违背 了 这 一 条 ， 然 后 把 该 类 
的 实例 添加 到 集合 Cealieetion) H, BRAH contains 方法 将 果断 的 告 
诉 你 ， 访 集合 不 包含 你 刚刚 添加 的 实例 。 


对 称 性 〈symmetric) 一 一 一 一 第 二 个 要 求 是 说 ， 任 何 两 个 对 象 对 

T ENTE BASE HI FRR AB AA 致 。 与 第 一 个 要 求 不 同 ， 大 无意 
中 违反 这 一 条 ， 这 种 情形 倒是 不 难 想 象 。 例 如 ， 考 虑 下 面 的 类 ， 它 实现 
Wg 字符 串 由 tostring 保存 ， 但 在 比较 操作 中 
BL HE o 


// Broken - violate symmetry 








public final class CaseInsensitiveString { 


private final String s; 


public CaseInsensitiveString (String s) { 
if (s == null ) 
throw new NullPointerException(); 


this .s = s; 


// Broken - violate symmetry! 
@Override public boolean equals (Object o) { 
if (o instanceof CaseInsensitiveString) 
return s.equalsIgnoreCase( 
((CaseInsensitiveString) 0).s); 
if (o instanceof String) // One-way interoperability! 
return s.equalsIgnoreCase((String) o); 


return false ; 


// Remainder omitted 


在 这 个 类 中 ， equals 方法 的 意图 非常 好 ， 它 企图 与 普通 的 字符 串 ( 
string ) 对 象 进行 互 操作 。 假 设 我 们 有 一 个 不 区 分 大 小 写 的 字符 串 
和 一 个 普通 的 字符 串 : 


CaseInsensitiveString cis = new CaseInsensitiveString( "Polish" ); 


String s = "polish" ; 


正如 所 料 ， cis.equals(s) 返回 true o 问题 在 于 ， 虽然 
CaseInsensitiveString 类 中 的 equals 方法 知道 普通 的 字符 串 ( o ) 
对 象 ， 但 是 ， string PHI equals 方法 却 并 不 知道 不 区 分 大 小 写 
A SAB 因此 ， s.equals(cis) 返回 false ， 显然 违反 了 对 称 性 。 
假设 你 把 不 区 分 大 小 写 的 字符 串 对 象 放 到 一 个 集合 中 


List<CaseInsensitiveString> list = new ArrayList<CaseInsensitiveString> 


list.add(cis); 


此 时 list.contains(s) 会 返回 什么 结果 呢 ? 没 人 知道 ， 在 Sun 的 当前 
实现 中 ， 它 碰巧 返回 faise ， 但 这 只 是 这 个 特定 实现 得 出 的 结果 而 
己 。 在 其 他 的 实现 中 ， 它 有 可 能 返回 true ， 或 者 抛 出 一 个 运行 时 
(runtime ) 异常 。 — AiR f equals 约定 ， 当 其 他 对 象 面 对 你 的 
对 象 时 ， 你 完全 不 知道 这 些 对 象 的 行为 会 这 么 样 。 

为 了 解决 这 个 问题 ， 只 需 把 企图 与 string 互 操作 的 这 段 代 码 从 
equals 方法 中 去 抒 就 可 以 了 。 这 样 做 之 后 ， 就 可 以 重 构 该 方法 ， 
使 它 变 成 一 条 单独 的 返回 语句 ; 


@Override public boolean equals (Object o) { 














return o instanceof CaseInsensitiveString && 


((CaseInsensitiveString) 0).s.equalsIgnoreCase(s); 


传递 性 (transitivity ) 一 equals 约定 的 第 三 个 要 求 是 ， 如 
果 一 个 对 象 等 于 第 二 个 对 象 ， 并 且 第 二 个 对 象 又 等 于 第 三 个 对 象 ， 
则 第 一 个 对 象 一 定 等 于 第 三 个 对 象 。 同 样 地 ， 无 意识 地 违反 这 条 规 
则 的 情形 也 不 难 想象 。 考 虑 子 类 的 情形 ， 它 将 一 个 新 的 值 组 件 

(value component) 添加 到 了 超 类 中 。 换 句 话说 ， 子 类 增加 的 信息 


会 影响 到 equals 的 比较 结果 。 我 们 首先 以 一 个 简单 的 不 可 变 的 二 
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y) í 


equals (Object o) { 


public class Point { 
private final int x; 
private final int y; 
public Point ( int x, int 
this =X; 
this .y = y; 
} 
@Override public boolean 
if (!(0 instanceof Point)) 
return false ; 
Point p = (Point)o; 
return p.x == x && p.y == y; 
} 
// Remainder omitted 
} 


假设 你 想 要 扩展 这 个 类 ， 为 一 个 点 添加 颜色 信息 ; 


public class ColorPoint extends Point { 
private final Color color; 
public ColorPoint ( int x, int y, Color color) { 
super (x, y); 
this .color = color; 
} 


// Remainder omitted 


equals 方法 会 怎么 样 呢 ? 如 有 果 完 全 不 提供 equas 方法 ， 而 是 直接 

从 Point 继承 过 来 ， 在 equals 做 比较 的 时 候 颜 色 信息 就 被 忽 LH FE 

了 。 虽 然 这样 做 不 会 违反 equis 约定 ， 但 是 很 明显 是 无 法 接受 

equals 方法 ， 只 有 当 它 的 参数 是 男 一 个 有 
点 ， 并 且 具 有 同样 的 位 置 和 颜色 时 ， 它 才 会 返回 true 


// Broken - violates symmetry! 











@Override public boolean equals (Object o) { 
if (!(o instanceof ColorPoint) ) 
return false ; 


return super .equals(o) && ((ColorPoint) o0).color == color; 





这 个 方法 的 问题 在 于 ， 你 在 比较 普通 点 和 有 人 色 点 ， 以 及 相反 的 情形 
时 ， 可 能 会 得 到 不 同 的 结果 。 前 一 种 比较 忽略 了 颜色 信息 ， 而 后 一 
种 比较 则 总 是 返回 fase ， 因 为 参数 的 类 型 不 正确 。 为 了 直观 地 说 
明 问 题 历 在 ， 我 们 创建 一 个 普通 点 和 一 个 有 色 点 : 


Point p = new Point( 1, 2 ); 


ColorPoint cp = new ColorPoint( 1, 2 , Color.RED); 


然后 ， p.equals(cp) 返回 true  ， cp.equals(p) 返回 false 。 你 可 以 做 
这 样 的 葵 试 来 修正 这 个 问题 ， 让 ColorPoint .equals 在 进行 < 混合 比 
较 ” 时 忽略 颜色 信息 : 


// Broken - violates transitivity! 
@Override public boolean equals (Object o) { 
if (!(o0 instanceof Point)) 


return false ; 


// If o is normal Point, do a color-blind comparison 
if (!(0 instanceof ColorPoint) ) 


return o.equals( this ); 


// 0 is a ColorPoint; do a full comparison 


return super .equals(o) && ((ColorPoint) o).color == color; 


这 种 方法 确实 提供 了 对 称 性 ， 但 是 却 牺 牲 了 传递 性 : 


ColorPoint p1 = new ColorPoint( 1 , 2 , Color.RED); 
Point p2 = new Point( 1, 2 ); 


ColorPoint p3 = new ColorPoint( 1, 2 , Color.Blue); 


此 时 ， p1.equals(p2) 和 p2.equals(p3) 都 返回 true » 但 是 
p1.equals(p3) 则 返回 false， {RY 本 违反 了 传递 性 o 前 两 种 比较 不 考 
虑 颜色 信息 CAR ， 而 第 三 种 比较 则 考虑 了 颜色 信息 。 


怎么 解决 呢 ? 事实 上 ， 这 是 面向 对 象 语 言 中 关于 等 价 关 系 的 一 个 基 
本 问题 。 我 们 无 法 在 扩展 可 实例 化 的 类 的 同时 ， 既 增加 新 的 值 组 
0 equals 约定 ， 除 非 愿意 放弃 面 同 对 象 的 抽象 所 种 


你 可 能 听 说 ， 在 equals 方法 中 用 getClass 测试 代替 instanceof 测 | 
试 ， 可 以 扩展 可 实例 化 的 类 和 增加 新 的 值 组 件 ， 同 时 保留 equals 
约定 : 


// Broken - violates Liskov substitution principle (page 40) 








@Override public boolean equals (Object o) { 
if (o == null || o.getClass() !== getClass()) 
return false ; 
Point p = (Point) o; 


return p.x == x && p.y == y; 





这 段 程序 只 有 当 对 象 具 有 相同 的 实现 时 ， 才 能 使 对 象 等 同 。 虽 然 这 
样 也 不 算 太 糟糕 ， 但 是 结果 却 是 无 法 接受 的 。 


假设 我 们 要 编写 一 个 方法 ， 以 检验 菜 个 整数 点 是 否 处 在 单位 加 中 。 
下 面 是 可 以 条 用 的 其 中 一 种 方法 : 


// Initialize UnitCircle to contain all Points on the unit circle 





Private static final Set<Point> unitCircle; 
static (Rf 
unitCircle = new HashSet<Point>(); 
unitCircle.add( new Point( 1, 0 )); 
unitCircle.add( new Point( 9, 1 )); 
unitCircle.add( new Point(- 1, 0 )); 


unitCircle.add( new Point( ©, - 1 )); 


public static boolean onUnitCircle (Point p) { 


return unitCircle.contains(p); 





虽然 这 可 能 不 是 实现 这 种 功能 的 最 快 方式 ， 不 过 它 的 效果 很 好 。 但 
是 假设 你 通过 某 种 不 添加 值 组 件 的 方式 扩展 了 point ， 例 如 让 它 的 
构造 占 记 录 创 建 了 多 少 个 实例 : 

public class CounterPoint extends Point { 


private static final AtomicInteger counter = new 
AtomicInteger(); 


public CounterPoint ( int x, int y) { 


super (x, y); 


counter.incrementAndGet(); 


} 


public int numberCreated () { return counter.get(); } 


ERËM) (Liskov subsititution) 认为 ， 一 个 类 型 的 任何 重要 


属性 也 将 适用 于 它 的 子 类 型 ， 因 此 为 该 类 型 编写 的 任何 方法 ， 在 它 
的 子 类 型 上 也 应 该 同样 运行 地 很 好 [Liskov87]。 但 是 假设 我 们 将 
CounterPoint 实例 传 给 了 onUnitCircle 方法 。 如 果 Point 类 使 用 了 基 
于 getClass 的 equals 方法 ， 无 论 CounterPoint 实例 的 X 和 y 值 是 
什么 ， onunitcircle 方法 都 会 返回 faise 。 之 所 以 如 此 ， 是 因为 像 
onUnitCircle 方法 所 用 的 HashSet 这 样 的 集合 ， | 用 equals 方法 检 
验 包 含 条 件 ， 没有 任何 CounterPoint 实例 与 任何 Point 对 应 。 但 

是 ， 如 果 在 Point 上 使 用 适当 的 基于 instanceof 的 equals 方法 ， = 
过 到 CounterPoint HF, 相同 的 onUnitCircle 方法 就 会 工作 得 很 好 。 


虽然 没有 一 种 令 人 满意 的 办 法 可 以 既 扩展 不 可 实例 化 的 类 ， 又 增加 
值 组 件 ， 但 还 是 有 一 种 不 错 的 权宜 之 计 (workaround) 。 根 据 第 16 
条 的 建议 : 复合 优先 于 继承 。 我 们 不 再 让 CounterPoint 扩展 Point 

， 而 是 在 counterpoint 中 加 入 一 个 私有 的 point 域 ， 以 及 一 个 公有 
的 视图 (view) 方法 〈 见 第 5 条 ) ， 此 方法 返回 一 个 与 该 有 色 点 处 
在 相同 位 置 的 普通 Point 对 和 象 : 


// Adds a value component without violating the equals contract 





public class ColorPoint { 
private final Point point; 


private final Color color; 


public ColorPoint ( int x, int y, Color color) { 
if (color == null ) 
throw new NullPointerException(); 
point = new Point(x, y); 


this .color = color; 


* Returns the point-view of this color point. 
=f 
pulic Point asPoint () { 


return point; 


@Override public boolean equals (Object o) { 
if (!(0 instanceof ColorPoint) ) 
return false ; 
ColorPoint cp = (ColorPoint) 0; 


return cp.point.equals(point) && cp.color.equals(color); 


// Remainder omitted 


在 Java 平 台 类 库 中 ， 有 一 些 类 扩展 了 可 实例 化 的 类 ， 并 添加 了 
新 的 值 组 件 。 例如 ， java.sql.Timestamp 对 java.util.Date 进行 了 
扩展 ， 并 增加 了 nanoseconds 域 。 Timestamp 的 equals 实现 确实 
违反 了 对 称 性 ， 如 果 timestamp 和 vate 对 象 被 用 于 同一 个 集合 
中 或 者 以 其 他 方式 被 混合 在 一 起 ， 则 会 引起 不 正确 的 行为 。 
Timestamp 类 有 一 个 免责 声明 ， 告诫 程序 员 不 要 混合 使 用 Date 
和 Timestamp 对 象 。 只 要 你 不 把 它们 混合 在 一 起 ， 就 不 会 有 厅 
烦 。 除 此 之 外 没有 其 他 的 措施 可 以 防止 你 这 么 做 ， 而 且 结果 导 
致 的 错误 将 很 难 调试 。 Timestamp 类 的 这 种 行为 是 个 错误 ， 不 
值得 效仿 。 


注意 ， 你 可 以 在 一 个 抽象 (abstract) 类 的 子 类 中 增加 新 的 值 
组 件 ， 而 不 会 违反 equas 预定 。 对 于 根据 第 20 条 的 建议 “用 类 
层次 (class hierarchies) 代 蔡 标签 类 (tagged class) ”而 得 到 的 
那 种 类 层次 结构 来 说 ， 这 一 点 非常 重要 。 例 如 ， 你 可 能 有 一 个 
抽象 的 shape 类 ， 它 没有 任何 值 组 件 ， circe 子 类 添加 了 一 个 
radius 域 ， Rectangle 子 类 添加 了 length 和 width 域 。 只 要 不 
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一 致 性 〈consistency) 一 一 equals 约定 的 第 四 个 要 求 
是 ， 如 果 两 个 对 象 相等 ， 它 们 就 必须 始终 保持 相等 ， 除 非 它 们 
中 有 一 个 对 象 〈 或 者 两 个 都 ) 被 修改 了 。 换 名 话说 ， 可 变 对 象 


在 不 同 的 时 候 可 以 与 不 同 的 对 象 相等 ， 而 不 可 变 对 象 则 不 会 这 
样 。 当 你 在 写 一 个 类 的 时 候 ， 应 该 仔细 考虑 她 是 否 应 该 是 不 可 
变 的 〈 见 第 15 条 ) 。 如 果 认 为 它 应 该 是 不 可 变 的 ， 就 必须 保证 
equals “方法 满足 这 样 的 限制 条 件 : 相等 的 对 象 永远 相等 ， 不 

相等 的 对 象 永远 不 相等 。 


无 论 是 否 是 不 可 变 的 ， 都 不 要 使 equas 方法 依赖 于 不 可 靠 的 
资源 。 如 宁 违 反 了 这 条 蔡 令 ， 要 想 满 足 一 致 性 的 要 求 就 十 分 

困难 了 。 例如 ， java.net.URL 的 equals 方法 依赖 于 对 URE 中 主 
机 IP 地 址 的 比较 。 将 一 个 主机 名 转变 成 IP 地 址 可 能 需要 访问 网 
络 ， 随 着 时 间 的 推移 ， 不 确保 会 产生 相同 的 结果 。 这 样 会 导致 
URL 的 equals 方法 违反 equals 约定 ， 在 实践 中 可 能 引发 一 些 
问题 。 (遗憾 的 是 ， 因 为 兼容 性 的 要 求 ， 这 一 行为 无 法 被 改 

变 。) 除了 极 少数 的 例外 情况 ， equals 方法 都 应 该 对 驻 留 在 
内 存 中 的 对 象 执行 确定 性 的 计算 。 


非 空 性 CNon-nullity) 一 一 一 一 最 后 一 个 要 求 没 有 名 称 ， 我 
姑且 chengtawei 称 它 为 " 非 空 行 (Non-nullity) ”， 意 思 是 指 所 
有 前 对 象 部 必须 不 等 于 wa 。 尽 管 很 难 想象 什么 情况 下 
o.equals(null) 调用 会 意外 地 返回 true 5 但 是 意外 抛 出 
NullPointerException 异常 的 情形 却 不 难 想 象 。 通用 约定 不 允许 
抛 出 NullPointerException 人 许多 类 的 equals 方法 都 通过 显 
FAK) muna 测试 来 防止 这 种 情况 ， 


@Override public boolean equals (Object o) { 














if (o == null ) 


return false ; 
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这 项 测试 是 不 必要 的 。 为 了 测试 其 参数 的 等 同性 。 equals 方 
法 必须 先 把 参数 转换 成 适当 的 类 型 ， 以 便 可 以 调用 它 的 访问 方 
法 Caccessor) ， 或 者 访问 它 的 域 。 在 进行 转换 之 前 ， equals 

e instanceof 操作 符 ， 检 查 其 参数 是 否 为 正确 的 次 


@Override public boolean equals (Object o) { 


if (!(o instaceof MyType) ) 
return false } 


MyType mt = (MyType) o; 
} 


如 末 漏 挤 了 这 一 步 的 类 型 检查 ， 并 且 传 递 给 equals 方法 的 参 
数 有 事 错 误 的 类 型 ， 那 么 equas 方法 将 会 抛 出 

ClassCastException 异常 ， IX Ib equals 的 约定 。 但 是 ， 如 
R instanceof 的 第 一 个 操作 数 为 null; 那么 ， 不 管 第 二 个 操作 
数 是 哪 种 类 型 ， instanceof 操作 符 都 会 指定 应 该 返回 false 
[JLS，15.20.2]。 因 此 ， 如 果 把 nu 传递 给 equas 方法 ， 类 型 
检查 就 会 返回 false ; 所 以 不 需要 单独 的 null 检查 。 


结合 所 有 这 些 要 求 ， 得 出 了 以 下 实现 蝇 质 量 eqvals 方法 的 诀 


P= 
IZ? 


1. 使 用 = 操作 符 检 查 “ 参 数 是 否 为 这 个 对 象 的 引 
用 ”。 如 果 是 ， 则 返回 true o 这 只 不 过 是 一 种 
性 能 优化 ， 如 果 比 较 操 作 有 可 能 很 昂贵 ， 就 值得 
这 么 做 。 


2. 使 用 instanceof 操作 符 检 查 “ 参 数 是 否 为 正确 的 
类 型 ”。 如 果 不 是 ， 则 返回 faise 。 一 般 说 来 ， 
所 谓 “ 正 确 的 类 型 * 是 指 equals 方法 所 在 的 那个 
类 。 有 些 情况 下 ， 是 指 该 类 所 实现 的 某 个 接口 。 
如 果 类 实现 的 接口 改进 了 equals 约定 ， 人 允许 在 
实现 了 该 接口 的 类 之 间 进 行 比较 ， 那 么 就 使 用 接 
O. RANO (collection interface) 如 set 、 
List ~ Map 和 Map .Entry 具有 这 样 的 特性 。 


3， 把 参数 转换 成 正确 的 类 型 。 因 为 转换 之 前 进行 
过 instanceof 测试 ， 所 以 确保 会 成 功 。 


4. 对 于 该 类 中 每 个 “关键 (significant) bh, 检查 
参数 中 的 域 是 否 与 该 对 象 中 对 应 的 域 相 匹配 ”。 
































如 果 这 些 测试 全 部 成 功 ， 则 返回 true ;人 否则 返 
E] faise 。 如 果 第 2 步 中 的 类 型 是 个 借口 ， 就 必 
须 通 过 接口 方法 访问 参数 中 的 域 ， 如 果 该 类 型 是 
个 类 ， 也 许 就 能 够 直接 访问 参数 中 的 域 ， 这 要 取 
决 于 它们 的 可 访问 性 。 


对 于 既 不 是 float 也 不 是 double 类 型 的 基本 类 型 
域 ， 可 以 使 用 == 操作 符 进 行 比较 ， 对 于 对 象 引 
用 域 ， 可 以 递归 地 调用 equais 方法 ; 对 于 float 
域 ， 可 以 使 用 Float .compare 方法 ; 对 于 double 
域 ， 则 使 用 Double.compare o 对 于 float 和 double 
域 进行 特殊 的 处 理 是 有 必要 的 ， 因 为 存在 着 
Float.NaN 、 -0.0f 以 及 类 似 的 double 常量 ; 详 
细 信 息 请 参考 Fioat.equals 的 文档 。 对 于 数组 
域 ， 则 要 把 以 上 这 些 指导 原则 应 用 到 每 个 元 素 
上 。 如 果 数 组 域 中 的 每 个 元 素 都 很 重要 ， 就 可 以 
使 用 发 行 版 本 1.5 中 新 增 的 其 中 一 个 Arrays.equals 
THE 

有 些 对 象 引 用 域 包含 nu 可 能 是 合法 的 ， 所 
以 ， 为 了 避免 可 能 导致 NullPointerException 异 
常 ， 则 使 用 下 面 的 习惯 用 法 来 比较 这 样 的 域 : 


(field == null ? o.field == null 
: field.equals(o. field) ) 

















如 果 tiea IRA o.fieldu 通常 是 相同 的 对 象 引 
用 ， 那 么 下 面 的 做 法 就 会 更 快 一 些 : 


(field == o.field || (field != null 
&& field.equals(o.field))) 


对 于 有 些 类 ， 比 如 前 面 提 到 的 

CaseInsensitiveString ZB, 域 的 比较 要 比 简 单 的 等 
同性 测试 复杂 的 多 。 如 果 是 这 种 情况 ， 可 能 会 
希望 保存 该 域 的 一 个 “ 范 式 《〈canonical form) ”, 
这 样 equals 方法 就 可 以 根据 这 些 范 式 进行 低 开 
销 的 精确 比较 ， 而 不 是 高 开销 的 非 精 确 比较 。 这 


种 方法 对 于 不 可 变 类 《〈 见 第 15 条 ) 是 最 为 合适 
如 果 对 象 可 能 发 生变 化 ， 就 必须 使 其 范式 保 
寺 最 新 。 


域 的 比较 顺序 可 能 会 影响 到 equals 方法 的 性 
能 。 为 了 获得 最 佳 的 性 能 ， 应 该 罪行 比较 最 有 可 
能 不 一 致 的 域 ， 或 者 是 开销 最 低 的 域 ， 最 理想 的 
情况 是 两 个 条 件 同时 满足 的 域 。 你 不 应 该 去 比较 
那些 不 属于 对 象 逻 辑 状 态 的 域 ， 例 如 用 于 同步 操 
作 的 tock 域 。 也 不 需要 比较 元 余 域 (redundant 
field) ， 因 为 这 些 元 余 域 可 以 由 “关键 域 ? 计 算 获 
得 ， 但 是 这 样 做 有 可 能 提高 equals 方法 性 能 。 
如 果 宛 余 域 代表 了 整个 对 象 的 综合 描述 ， 比 较 这 
个 域 可 以 节省 当 比 较 失 败 时 去 比较 实际 数据 所 需 
要 的 开销 。 例 如 ， 假 设 有 一 个 polygon X, FFA 
存 了 该 区 域 。 如 果 两 个 多 边 形 有 着 不 同 的 区 域 ， 
束 没 有 必要 去 比较 它们 的 边 和 至 高 点 。 


当 你 编写 完成 了 equals 方法 之 后 ， 应 该 问 自己 
三 个 问题 : 它 是 不 是 对 称 的 、 传 递 的 、 一 致 

的 ? 并 且 不 要 只 是 自 间 ， 还 要 编写 单元 测试 来 
检验 这 些 特 性 ! 如 有 果 答 案 是 否定 的 ， 就 要 找 出 原 
因 ， 再 相应 地 修改 equis 方法 的 代码 。 当 然 ， 

equals 方法 也 必须 满足 其 他 两 个 特性 〈 目 反 性 
和 非 空 性 ) ， 但 是 这 两 种 特性 通常 会 自动 满足 。 


根据 上 面 的 诀窍 构 建 的 equals 方法 的 具体 例子 ， 请 参看 


第 9 条 的 PhoneNumber.equals o 下 面 是 最 后 的 一 些 告诫: 


(e) 7 equals HTA BB y Fe hashCode ( 见 第 9 
条 ) 


o 不 要 企图 让 equals 方法 过 于 智能 。 如 果 只 
是 简单 地 测试 域 中 的 值 是 否 相 等 ， 则 不 难 做 
到 遵守 equals 约定 。 如 果 想 过 度 地 去 寻求 
各 种 等 价 关 系 ， 则 很 容易 陷入 麻烦 之 中 。 把 
任何 一 种 别名 形式 考虑 到 等 价 的 范围 内 ， 往 
往 不 会 是 个 好 主意 。 例 如 ， rire 类 不 应 该 























视图 把 指 问 同一 个 文件 的 符号 链接 
(symbolic link) 当 作 相 等 的 对 象 来 看 待 。 
ARSE rire 类 没有 这 样 做 。 


不 要 将 equals 声明 中 的 Object XY RFR 
为 其 他 的 类 型 。 程 序 员 编写 出 下 面 这 样 的 
equals 方法 并 不 鲜 见 ， 这 会 使 程序 员 花 上 
数 个 小 时 都 搞 不 清 为 什么 它 不 能 正常 工作 : 


public boolean equals (MyClass o) { 





} 


ET, RATES A A m 
Object.equals ， 因为 它 的 参数 应 该 是 Object 
类 型 ， 相 反 ， 它 重 载 Coverload) 了 
Object.equals ( 见 第 41 条 ) 。 在 原 有 equals 
方法 的 基础 上 ， 再 提供 一 个 < 强 类 型 
(strongly typed) ”的 equals 方法 ， 只 要 这 
两 个 方法 返回 同样 的 结果 (没有 强制 的 理由 
必须 这 样 做 ) ， 那 么 这 就 是 可 以 接受 的 。 在 
某 些 特定 的 情况 下 ， 它 也 许 能 够 稍微 改善 性 
能 ， 但 是 与 增加 的 复杂 性 相 比 ， 这 种 做 法 是 
不 值得 的 〈 见 第 55 条 ) 。 


@override 注解 的 用 法 一 致 ， 束 如 本 条 目 所 
示 ， 可 以 防止 犯 这 种 错误 〈 见 第 36 条 ) 。 这 
个 eauals 方法 不 能 编译 ， 错 误 消 奶 ns 
你 到 底 哪 里 出 了 问题 : 


@Override public boolean equals 
(MyClass o) { 


TANS ===} y 
第 9 条 : fei equals 时 总 要 
Hs at hashCode 


MIRE ILIRI ET A it, nashcode 方法 。 
ERDE m S equals 方法 的 类 中 ， tH Zi ait 
hashcode 方法 。 如 果 不 这 样 做 的 话 ， 束 会 违反 
Object.hashcode 的 通用 约定 ， 从 而 导致 该 类 无 法 结合 
所 有 基于 散 列 的 集合 一 起 正常 工作 ， 这 样 的 集合 包括 


HashMap 、 HashSet 和 Hashtable oœ 
下 面 是 约定 的 内 容 ， 摘 自 opject 规范 [JavaSE6]j: 


a 在 应 用 程序 的 执行 期 间 ， 只 要 对 象 的 equals 方 
法 的 比较 操作 所 用 到 的 信息 没有 被 修改 ， 那 么 对 
同一 个 对 象 调 用 多 次 ， hashCode 方法 都 必须 始终 
如 一 地 返回 同一 个 整数 。 在 同一 个 应 用 程序 的 多 
， 每 次 执行 所 返回 的 整数 可 以 不 一 


SE 

如 果 两 个 对 象 根据 equals(object) 方法 比较 是 相等 
的 ， 那 么 调用 这 两 个 对 象 中 任意 一 个 对 象 的 
hashCode 方法 都 必须 产生 同样 的 整数 结果 。 

如 果 两 个 对 象 根据 equals(opject) 方法 比较 是 不 相 
等 的 ， 那 么 调用 这 两 个 对 象 中 任意 一 个 对 象 的 
hashcode 方法 ， 则 不 一 定 要 产生 不 同 的 整数 结 
果 。 但 是 程序 员 应 该 知道 ， 给 不 相等 的 对 象 产生 
截然 不 同 的 整数 结果 ， 有 可 能 提高 散 列 表 (hash 
table) 的 性 能 。 


AWA ttt hashCode 而 违反 的 关键 约定 是 第 二 条 : 
相等 的 对 象 必 须 具 有 相等 的 散 列 人 码 (hash code) 。 
根据 类 的 equals 方法 ， 两 个 截然 不 同 的 实例 在 逻辑 
上 有 可 能 是 相等 的 ， 但 是 ， 根 据 opject 类 的 nashcode 
方法 ， 它 们 仅仅 是 两 个 没有 任何 共同 之 处 的 对 象 。 
此 ， WAN hashCode 方法 返回 两 个 看 起 来 是 随机 的 整 
数 ， 而 不 是 根据 第 二 个 约定 所 要 求 的 那样 ， 返 回 两 个 
相等 的 整数 。 

















例如 ， 考虑 下 面 这 个 极为 简单 的 PhoneNumber 类 ， 它 的 
a 方法 是 根据 第 8 条 中 给 出 的 “* 诀 罕 ” 构 造 出 来 


public final class PhoneNumber { 





private final short areaCode; 
private final short prefix; 


private final short lineNumber; 


public PhoneNumber ( int areaCode, int prefix, 
int lineNumber) { 
rangeCheck(areaCode, 999 , "area code" ); 
rangeCheck (prefix, 999 , "prefix" ); 
rangeCheck(lineNumber, 9999 , "line number" ); 
this .areaCode = ( short ) areaCode; 
this .prefix = ( short ) prefix; 


this .lineNumber = ( short ) lineNumber; 


private static void rangeCheck ( int arg, int 


max, 
String name) { 
if (arg < © || arg > max) 
throw new IllegalArgumentException(name + 
": " Elangye 
} 


@Override public boolean equals (Object o) { 
if (o == this ) 
return true ; 
if (!(0 instanceof PhoneNumber) ) 
return false ; 


PhoneNumber pn = (PhoneNumber )o; 


return pn.lineNumber == lineNumber 


&& pn.prefix == prefix 


&& pn.areaCode == areaCode; 
// Broken - no hashCode method 
// ... Remainder omitted 


假设 你 企图 将 这 个 类 与 Hashwap 一 起 使 用 : 
Map<PhoneNumber, String> m 
= new HashMap<PhoneNumber, String>(); 


m.put( new PhoneNumber( 707 , 867 , 5309 ), 
"Jenny" ); 


mle a :可 能 期 望 由 PhoneNumber(707, 867, 
5309)) 会 返回 : pane ， 但 它 实 际 上 返回 的 是 

null “注意 ， 里 涉及 两 个 PhoneNumber 实例 : 
党 个 被 用 于 插入 到 HashMap 中 ， 第 二 个 实例 与 
第 一 个 相等 ， 被 用 于 《试图 用 于 ) 获取 。 由 于 
PhoneNumber ZEB 8 hashCode 方法 ， 从 而 导致 
两 个 相等 的 实例 具有 不 相等 的 散 列 码 ， 违 反 了 
hashCode 的 约定 。 因此 ， put 方法 把 电话 号 人 码 对 
象 存放 在 一 个 散 列 桶 (hash bucket) 中 ， get 方 
法 却 在 另 一 个 散 列 桶 中 查找 这 个 电话 号 码 。 即 使 
这 两 个 实例 正好 被 放 在 同一 个 散 列 桶 中 ， eet 方 
法 也 必定 会 返回 null ， 因 为 hasnwap 有 一 项 优 
化 ， 可 以 将 每 个 项 相关 联 的 散 列 码 缓存 起 来 ， 如 
果 散 列 码 不 匹配 ， 也 不 必 检 验 对 象 的 等 同性 。 


修正 这 个 问题 非常 简单 ， 只 需 为 phonenumber 类 提 
供 一 Teg hashCode 方法 即 可 。 那儿 》 
hashcode 方法 应 该 是 什么 样 的 呢 ? 编导 一 个 合法 





但 并 不 好 用 的 hashCode 方法 没有 任何 价值 。 例 
如 ， 下 面 这 个 方法 总 是 合法 ， 但 是 永远 都 不 应 该 
被 正式 使 用 : 


// The worst possible legal hash function - never use! 





@Override public int hashCode () { return 
42 ; } 


上 面 这 个 hashcode 方法 是 合法 的 ， 因 为 它 确保 了 
相等 的 对 象 总 是 具有 同样 的 散 列 码 。 但 它 也 极为 
恶劣 ， 因 为 它 使 得 每 个 对 象 都 具有 同样 的 散 列 
码 。 因 此 ， 每 个 对 象 都 被 映射 到 同一 个 散 列 桶 
中 ， 使 散 列 表 退 化 为 链表 (inked list) 。 它 使 得 
本 该 线性 时 间 运 行 的 程序 变 成 了 以 平方 级 时 间 在 
运行 。 对 于 规模 很 大 的 散 列 表 而 言 ， 这 会 关系 到 
散 列 表 能 否 正常 工作 。 


一 个 好 的 散 列 函数 通常 倾向 于 “为 不 相等 的 对 象 
产生 不 相等 的 散 列 码 ”。 这 正 是 hashCode 约定 中 
第 三 条 的 含义 。 理 想 情 况 下 ， 散 列 函 数 应 该 把 集 
合 中 不 相等 的 实例 均匀 地 分 不 到 所 有 可 能 的 散 列 
值 上 。 要 想 完 全 达到 这 种 理想 的 情形 是 非常 困难 
的 。 侠 运 的 是 ， 相 对 接近 这 种 理想 情形 则 并 不 太 
昔 难 。 下 面 给 出 一 种 简单 的 解决 办 法 : 


1. 把 某 个 非 零 的 常数 值 ， 比 如 说 17， 
保存 在 一 个 名 为 result 的 int 类 
型 的 变量 中 。 

2, 对 于 对 象 中 每 个 关键 域 t GE 
equals 方法 中 涉及 的 每 个 域 ) ’ 
完成 以 下 步骤 : 


a. 为 该 域 计算 int 类 型 的 散 列 码 。 

















i. 如 果 该 域 是 boolean 类 型 ， 则 计 
算 Grale 0O A 


il. 如 果 该 域 是 byte 、 char 、 
short 或 者 int 类 型 ， 则 计算 


(int)f o 


iii. 如 果 该 域 是 iong 类 型 ， 则 计算 


(int)(f ^ (f >>> 32)) o 


iv. 如 果 该 域 是 float 类 型 ， 则 计算 


Float.floatToIntBits(f) oœ 


v. 如 果 该 域 是 double 类 型 ， 则 计 
算 OTR doubleToLongBits(f)  ， 然后 
按照 步骤 2.a. 证 ， 为 得 到 的 iong 类 
型 值 计算 散 列 值 。 


vi. 如果 该 域 是 一 个 对 象 引 用 ， 并 
且 该 域 的 equals 方法 通过 递归 地 
调用 equals 的 方式 来 比较 这 个 
域 ， 则 同样 为 这 个 域 递归 地 调用 
hashCode oœ 如 果 需 要 更 复杂 的 比 
较 ， 则 为 这 个 域 计 算 一 个 “范式 
(canonical representation) ”然后 
针对 这 个 范 亡 式 调用 hashCode 。 如 果 
这 个 域 的 值 为 nuall ， 则 返回 0 (或 
者 其 他 茶 个 常数 ， 但 通常 是 0〉。 


vii. 如 果 该 域 是 一 个 数组 ， 则 要 把 
每 一 个 元 素 当 做 单独 的 域 来 处 理 。 
也 就 是 说 ， 递 归 地 应 用 上 述 规则 ， 
对 每 个 重要 的 元 素 计 算 一 个 散 列 
码 ， 然 后 根据 步骤 2.b 中 的 做 法 把 
这 些 散 列 值 组 合 起 来 。 如 条 数组 域 
中 的 每 个 元 素 都 很 重要 ， 可 以 利用 
发 行 版 本 1.5 中 增加 的 其 中 一 个 
Arrays.hashCode 方法 。 


b. 按照 下 面 的 公式 ， 把 步骤 2.a 中 计 
算得 到 的 散 列 码 合并 到 result 











中 : 


result = 31 * result + C; 


返回 result。 


写 完了 hashcode 方法 之 后 ， 问 问 目 
己 “ 相 等 的 实例 是 否 都 具有 相等 的 
散 列 码 ”。 要 编写 单元 测试 来 验证 
你 的 推 煌 。 如 果 相 等 实例 有 痢 不 相 
等 的 散 列 码 ， 则 要 找 出 原因 ， 并 修 


正 错误 。 


在 散 列 人 码 的 计算 过 程 中 ， 可 以 把 元 余 域 
(redundant field) 排除 在 外 。 换 句 话说 ， 
如 果 一 个 域 的 值 可 以 根据 参与 计算 的 其 他 域 
值 计算 出 来 ， 则 可 以 把 这 样 的 域 排除 在 外 。 
必须 排除 equals 比较 计算 中 没有 用 到 的 任 
何 域 ， 否则 很 有 可 能 违反 hashCode 约定 的 第 


a 


上 述 步骤 1 中 用 到 了 一 个 非 零 的 初始 值 ， 
此 步骤 2.a 中 计算 的 散 列 值 为 0 的 那些 初始 
域 ， 会 影响 到 散 列 值 。 如 果 步 又 1 中 的 初始 
值 为 0%0， 则 整个 散 列 值 将 不 受 这 些 初 始 域 的 
影响 ， 因 为 这 些 初始 域 会 增加 冲突 的 可 能 
性 。 值 a7 则 是 任 选 的 。 


步骤 2.b 中 的 乘法 部 分 使 得 散 列 值 依赖 于 域 
的 顺序 ， 如 果 一 个 类 包含 多 个 相似 的 域 ， 这 
样 的 乘法 运算 就 会 产生 一 个 更 好 的 散 列 函 

数 。 例 如 ， 如 果 string 散 列 函 数 省 略 了 这 
个 乘法 部 分 ， 那 么 只 是 字母 顺序 不 同 的 所 有 
字符 串 都 会 有 相同 的 散 列 码 。 之 所 以 选择 

31， 是 因为 它 是 一 个 奇 系数 。 如 果 乘 数 是 侦 
数 ， 并 且 乘 法 溢出 的 话 ， 信 息 束 会 去 失 ， 因 
为 与 2 相 乘 等 价 于 位 移 运 算 。 使 用 和 聂 数 的 好 
处 并 不 很 明显 ， 但 是 习惯 上 都 使 用 素数 来 计 























算 散 列 结果 。31 有 个 很 好 的 特性 ， 即 用 位 移 
aaia Ka 可 以 得 到 更 好 的 性 能 

*i==(i<<5)-i 。 现 代 的 VM 可 以 自动 
完成 这 种 优化 。 


现在 我 们 要 把 上 述 的 解决 办 法 用 到 
PhoneNumber 类 中 。 它 有 三 个 关键 域 ， 都 是 


short 类 型 . 








@Override public int hashCode () { 


int result = 17 ; 


result = 31 * result + areaCode; 
result = 31 * result + prefix; 
result = 31 * result + lineNumber; 


return result; 


} 


因为 这 个 方法 返回 的 结果 是 一 个 简单 的 、 确 
定 的 计算 结果 ， 它 的 输入 只 是 PhoneNumber 实 
例 中 的 三 个 关键 域 ， 因此 相等 的 PhoneNumber 
显然 都 会 有 相等 的 散 列 码 。 实 际 上 ， 对 于 
PhoneNumber 的 hashCode 实现 而 言 ， 上 面 这 个 
方法 是 非常 合理 的 ， 相 当 于 Java 平 台 类 库 中 
的 实现 。 它 的 做 法 非常 人 简单， 也 相当 快捷 ， 
e 分 散 到 不 同 的 散 
wl 


如 果 一 个 类 是 不 可 变 的 ， 并 且 计 算 散 列 码 的 
开销 也 比较 大 ， 就 应 该 考虑 把 散 列 码 缓存 在 
对 象 内 部 ， 而 不 是 每 次 请 求 的 时 候 都 重新 计 
算 散 列 码 。 如 果 你 觉得 这 种 类 型 的 大 多 数 对 
象 会 被 用 作 散 列 键 (hash keys) ， 就 应 该 在 
创建 实例 的 时 候 计 算 散 列 码 。 否 则 ， 可 以 选 
择 “ 延迟 初始 化 (lazily initialize) ” 散 列 三 ， 
一 直到 nashcode 被 第 一 次 调用 的 时 候 才 初始 
化 〈 见 第 71 条 ) 。 现 在 尚 不 清楚 我 们 的 














PhoneNumber 类 是 否 值得 这 样 处 理 , 但 可 以 通 
过 它 来 说 明 这 种 方法 该 如 何 实现 : 
// Lazily initialized, cached hashCode 


private volatile int hashCode; 
// (See item 71) 


@Override public int hashCode () { 
int result = hashCode; 
if (result == 0) { 


result = 17 ; 


result = 31 * result + areaCode; 
result = 31 * result + prefix; 
result = 31 * result + lineNumber; 


hashCode = result; 


} 


return result; 


虽然 本 条 H 中 前 面 给 出 的 hashCode 实现 方法 
能 够 获得 相当 好 的 散 列 函数 ， 但 是 它 并 不 能 
产生 最 新 的 散 列 函数 ， 和 截止 发 行 版 本 1.6， 
Java 平 台 类 库 也 没有 提供 这 样 的 散 列 函数 。 
编写 这 种 散 列 函数 是 个 研究 课题 ， 最 好 留 给 
数学 家 和 理论 方面 的 计算 机 科学 家 来 完成 。 
也 许 Java 平 台 的 下 一 个 发 行 版 本 将 会 为 它 的 
类 提供 这 种 最 佳 的 散 列 函数 ， 并 提供 一 些 实 
用 方法 来 帮助 普通 的 程序 员 构 造 出 这 样 的 散 
列 函 数 。 与 此 同时 ， 本 条 目 中 介绍 的 方法 对 
于 绝 大 多 数 应 用 程序 而 言 已 经 足够 了 。 


不 要 试图 从 散 列 码 计 算 中 排除 挥 一 个 对 象 的 
关键 部 分 来 提高 性 能 。 虽 然 这 样 的 散 列 函 
数 运行 起 来 可 能 更 快 ， 但 是 它 的 效果 不 见得 
会 好 ， 可 能 会 导致 散 列 表 慢 到 根本 无 法 使 
用 。 特 别 是 在 实践 中 ， 散 列 函数 可 能 面临 大 

















量 的 实例 ， 在 你 选择 忽略 的 区 域 中 ， 这 些 实 
例 仍 然 区 别 非常 大 。 如 果 是 这 样 ， 散 列 函 数 
束 会 把 所 有 这 些 实例 映射 到 极 少 数 的 散 列 码 
上 ， 基 于 散 列 的 集合 将 会 显示 出 平方 级 的 性 
能 指标 。 这 不 仅仅 是 个 理论 问题 。 在 Java 
1.2 发 行 版 本 之 前 实现 的 string 散 列 函数 至 
多 只 检查 16 个 字符 ， 从 第 一 个 字符 开始 ， 在 
整个 字符 串 中 均匀 选取 。 对 于 像 URL 这 种 层 
次 状 名 字 的 大 型 集合 ， 该 散 列 函数 正好 表现 
出 了 这 里 所 提 到 的 病态 行为 。 


Java 平 台 类 库 中 的 许多 类 ， 比 如 string 、 

Integer 和 pate ， 都 可 以 把 它们 的 nashcode 
方法 返回 的 确切 值 规定 为 该 实例 值 的 一 个 函 
数 。 一 般 来 说 ， 这 并 不 是 个 好 主意 ， 因 为 这 
样 做 严格 地 限制 了 在 将 来 的 版 本 中 改进 散 列 
函数 的 能 力 。 如 果 没 有 规定 散 列 函数 的 细 

节 ， 那 么 当 你 发 现 了 它 的 内 部 缺陷 时 ， 束 可 
以 在 后 面 的 发 行 版 本 中 修正 它 ， 确 信 没 有 任 
何 客户 端 会 依赖 于 散 列 函数 返回 的 确切 值 。 


ra Bs 
第 10 条 : WAR m 
toString 











虽然 java.lang.Object 提供 了 toString 方法 的 
一 个 实现 ， 但 它 返 回 的 字符 串通 常 不 是 类 的 
用 户 所 期 望 看 到 的 。 它 包含 类 的 名 称 ， 以 及 
一 个 “@” 符 号 ， 接 着 是 散 列 码 的 无 符号 十 六 
进 制 表示 法 。 例 如 “ phonenumber@16sb91 ”。 
toString 的 通用 约定 之 处 ， 被 返回 的 字符 串 
应 该 是 一 个 “简洁 的 ， 但 信息 丰富 ， 并 且 易 
于 阅读 的 的 表达 形式 ”[JavaSE6]。 尺 管 有 人 
认为 和 PhoneNumber@163b91 ”算得 上 是 简洁 和 易 
于 阅读 了 ， 但 是 与 “(707)867-5309” 比 较 起 
来 ， 它 还 算 不 上 是 信息 丰富 的 。 toString 的 
约定 进一步 之 处 , SENNA ITARA at 








这 个 方法 。” 这 是 一 个 很 好 的 建议 ， 真 的 ! 


虽然 遵守 toString 的 约定 并 不 像 遵 守 equals 
和 hashCode 的 约定 ( 见 第 8 条 和 第 9 条 ) 那么 
重要 ， 但 是 ， 提供 好 的 tostring 实现 可 以 
使 类 用 起 来 更 加 舒适 。 当 对 象 被 传递 给 
println 、 printf 、 字符 串联 操作 符 ( 十 
) 以 及 assert 或 者 航 调试 器 打印 出 来 时 ， 
toString 方法 会 被 自动 调用 。 (Java 1.5 发 
行 版 本 在 平台 中 增加 了 printf 方法 ， 还 提 
供 了 包括 string.format 的 相关 方法 ， 与 C 语 
言 中 的 sprint 相似 。) 


如 果 为 phonenumber 提供 了 好 的 tostring 方 
法 ， 那 么 ， 要 产生 有 用 的 诊断 消息 会 非常 容 
易 : 








System,out.println( "Failed to connect: " 
+ phoneNumber ); 





WN eat I tostring 方法 ， 程 序 员 都 将 
以 这 种 方式 来 产生 诊断 消息 ， 但 是 如 果 没 有 
7 toString 方法 ， 产生 的 消息 将 难以 理 
解 。 提供 好 的 toString 方法 ， 不 仅 有 益 于 这 
个 类 的 实例 ， 同 样 也 有 益 于 那些 包含 这 些 实 
例 的 引用 的 对 象 ， 特 别 是 集合 对 象 。 打 印 
map 时 有 下 面 这 两 条 消息 : “ 
Jenny=PhoneNumber@163b91 ”和 “ Jenny=(408)867-5309 


”， 你 更 愿意 看 到 哪 一 个 ? 


在 实际 应 用 中 ， toString 方法 应 该 返回 对 
象 中 包含 的 所 有 值得 关注 的 信息 ， 壁 如 上 
述 电 话 号 码 例子 那样 。 如 果 对 象 太 大 ， 或 者 
对 象 中 包含 的 状态 信息 难以 用 字符 串 来 表 
达 ， 这 样 做 就 有 点 不 切实 际 。 在 这 种 情况 
下 ， tostring 应 该 返回 一 个 摘要 信息 ， 例 
uy Manhattan white pages (1487536 listings) ”或 


者 “ Thread[main, 5, main] ee 理想 情况 下 ， 字 

















符 串 应 该 是 自 描 述 的 《〈self-explanatory) , 
( Thread 例子 不 满足 这 样 的 要 求 。 ) 


在 实现 tostring 的 时 候 ， 必 须要 做 出 一 个 很 
HUE: 是 侣 在 文档 中 指定 返回 值 的 格 
式 。 对 于 值 类 (value class) ， 比 如 电话 号 
码 类 、 和 矩阵 类 ， 也 建议 这 么 做 。 指 定格 式 的 
好 处 是 ， 它 可 以 被 用 作 一 种 标准 的 、 明 确 
的 、 适 合 人 阅读 的 对 象 表示 法 。 这 种 表示 法 
可 以 用 于 输入 和 和 输出， 以 及 用 在 永久 的 适合 
人 类 阅读 的 数据 对 象 中 。 例 如 XML 文档 。 
如 果 你 指定 了 格式 ， 最 后 再 提供 一 个 相 匹 配 
的 静态 工厂 或 者 构造 器 ， 以 便 程序 员 可 以 很 
容易 地 在 对 象 和 它 的 字符 串 表示 法 之 间 来 回 
转换 。Java 平 台 类 库 中 的 许多 值 类 都 采用 了 
这 种 做 法 ， 包括 BigInteger 、 BigDecimal 和 
绝 大 多 数 苏 的 基本 类 型 包装 类 (boxed 


primitive class) 。 


指定 tostring 返回 值 的 格式 也 有 不 足 之 处 : 
如 果 这 个 类 已 经 被 广泛 使 用 ， 一 旦 指定 格 
式 ， 就 必须 始终 如 一 地 坚持 这 种 格式 。 程 序 
员 将 会 编写 出 相应 的 代码 来 解析 这 种 字符 串 
表示 法 、 产 生字 符 串 表示 法 ， 以 及 把 字符 串 
表示 法 藤 入 到 持久 的 数据 中 。 如 果 将 来 的 发 
行 版 本 中 改变 了 这 种 表示 法 ， 束 会 破坏 他 们 
的 代码 和 数据 ， 他 们 当然 会 抱 乱 。 如 果 不 指 
定格 式 ， 就 可 以 保留 灵活 性 ， 便 于 在 将 来 的 
发 行 版 本 中 增加 信息 ， 或 者 改进 格式 。 


无 论 你 是 否决 定 指定 格式 ， 都 应 该 在 文档 中 
明确 的 表明 你 的 意图 。 如 果 你 要 指定 格 
式 ， 则 应 该 严格 地 这 样 去 做 。 例 如 ， 下 面 是 
第 9 条 中 PhoneNumber 类 的 toString 方法 : 














* Returns the string representation of this phone number. 


* The string consists of fourteen characters whose fo 


rmat 


* 


is "(XXX) YYY- 


ZZZZ", where XXX is the area code. YYY is 


k 


27 


the prefix, and ZZZZ is the line number. (Each of the 


capital letters represents a single decimal digit.) 


If any of the three parts of this phone number is too sm 
to fill up its field, the field is padded with leading z 
For example, if the value of the line number is 123, the 


four characters of the string representation will be "01 


Note that there is a single space separating the closing 
parenthesis after the area code from the first digit of 


prefix. 


@Override public String toString () { 


return String.format( "(%03d) %03d-%04d" , 


areaCode, prefix, lineNumber); 


如 果 你 绝 低 挡 不 指定 格式 ， 那 么 文档 注释 音 
分 也 应 该 有 如 下 所 示 的 指示 信息 : 


/ 


类 类 


* 


* 


wd 





Returns a brief description of this potion. The exact de 


of the representation are unspecified and subject to cha 


@Override public String toString () 


ee: 


} 








对 于 那些 依赖 于 格式 的 细节 进行 编程 或 者 产 
生 永 久 数 据 的 程序 猴 ， 在 读 到 这 段 注释 之 
后 ， 一 旦 格式 被 改变 ， 则 只 能 目 己 承担 后 


果 。 


无 论 是 否 指定 格式 ， 都 为 tostring 返回 值 
中 包含 的 所 有 信息 ， 提 供 一 种 编程 式 的 访问 
途径 o 例如 ， PhoneNumber 类 应 该 包含 针对 
area code、Pprefixz 和 jline number 的 访问 方法 。 
如 果 不 这 么 做 ， 就 会 迫使 那些 需要 这 些 信息 
的 程序 员 不 得 不 自己 去 解析 这 些 字 符 串 。 除 
了 降低 了 程序 的 性 能 ， 使 得 程序 员 们 去 做 这 
些 不 必要 的 工作 之 外 ， 这 个 解析 过 程 也 很 容 
易 出 错 ， 会 导致 系统 不 稳定 ， 如 果 格 式 发 生 
变化 ， 还 会 导致 系统 朋 演 。 如 果 没 有 提供 这 
些 访问 方法 ， 即 使 你 已 经 指明 了 字符 串 的 格 
式 是 可 以 变化 的 ， 这 个 字符 串 格 式 也 成 了 事 
实 上 的 API。 


第 11 条 : VET A m 


clone 


cloneable 接口 的 目的 是 作为 对 象 的 的 一 个 
mixin 接 口 (mixin interface) (〈 见 第 18 

条 ) ， 表 明 这 样 的 对 象 允许 克隆 (clone) 。 
遗憾 的 是 ， 它 并 没有 成 功 地 达到 这 个 目的 。 
其 主要 的 缺陷 在 于 ， ERD clone 方 
法 ， Object 的 clone 方法 是 受 保 护 的 。 如 果 
不 借助 于 反射 Creflection) 〈 见 第 53 条 ) ， 
就 不 能 仅 仪 因为 一 个 对 象 实现 了 Cloneable 

， 就 可 以 调用 clione 方法 。 即 使 是 反射 调用 
也 可 能 会 是 该 ， 因 为 不 能 保证 该 对 象 一 定 具 
有 可 访问 的 clone His 尽管 存在 这 样 那样 
的 缺陷 ， 这 项 设施 仍然 被 广泛 地 使 用 着 ， 因 
此 值得 我 们 进一步 地 了 解 。 本 条 目 将 告诉 你 
如 何 实现 一 个 行为 良好 的 clone Fie, 并 讨 
论 何 时 适合 这 样 做 ， 同 时 也 简单 地 讨论 了 其 
他 的 可 蔡 换 做 法 。 


既然 Cloneable 并 没有 包含 任何 方法 ， 那么 
它 到 底 有 什么 作用 呢 ?” 它 决定 了 object 中 

















受 保护 的 cioe 方法 实现 的 行为 如果 一 个 
类 实现 了 Cloneable ， Object 的 clone 方法 
POR EI TAX RUNER I, 否则 就 会 抛 出 
CloneNotSupportedException 异常 。 这 是 接口 的 
一 种 极端 非典 型 的 用 法 ， 也 不 值得 效仿 。 通 
常情 况 下 ， 实 现 接 口 是 为 了 表明 类 可 以 为 它 
的 客户 做 此 什么 。 然而 ， 对 于 Cloneable 接 
口 ， 它 改变 了 超 类 中 受 保护 的 方法 的 行为 。 


如 果实 现 cloneable 接口 是 要 对 某 个 类 起 到 
租用 ， 类 和 它 的 所 有 超 类 都 必须 遵守 一 个 相 
当 复 杂 的 、 不 可 实施 的 ， 并 且 基 本 上 没有 文 
档 说 明 的 协议 。 由 此 得 到 一 种 语言 之 外 的 

Cextralinguistic) 机 制 : 无 需 调 用 构造 器 就 
可 以 创建 对 象 。 


cone 方法 的 通用 约定 是 非常 弱 的 ， 下 面 是 
5 自 java.lang.Object 规范 中 的 约定 内 容 
[JavaSE6]: 


EINE AI TEL TRAN TEN. AAN 
精确 含义 取决 于 该 对 象 的 类 。 一 般 的 含义 
是 ， 对 于 任何 对 象 x REA 


x.clone() != x 














将 会 是 true » FFA, RIEA 


x.clone().getClass() == x.getClass() 


将 会 是 true ， 但 这 些 都 不 是 绝对 的 要 求 。 
虽然 通常 情况 下 ， 表 达 式 


x.clone().equals(x) 


将 会 是 true ， 但 是 ， 这 也 不 是 一 个 绝对 的 
要 求 。 找 贝 对 象 的 往往 会 导致 创建 它 的 类 的 
一 个 新 实例 ， 但 它 同 时 也 会 要 求 找 贝 内 部 的 





数据 结构 。 这 个 过 程 中 没有 调用 构造 器 。 


这 个 约定 存在 几 个 问题 。“ 不 调用 构造 器 ”的 
规定 太 强 便 了 。 行为 良好 的 clone 方法 可 以 
调用 构造 器 来 创建 对 象 ， 构 造 之 后 再 复制 内 
部 数据 。 如 果 这 个 类 是 final 的 ， clone 其 
至 可 能 会 返回 一 个 由 构造 器 创建 的 对 象 。 


然而 ， x.clone().getClass() 通常 应 该 等 同 于 
x.getclass() 的 规定 又 太 软弱 了 。 在 实践 
中 ， 程 序 员 会 假设 : 如 果 他 们 扩展 了 一 个 
ZB, 并 且 从 子 类 中 调用 了 super.clone  ， 返回 
的 对 象 就 将 是 该 子 类 的 实例 。 超 类 能 够 提供 
这 种 功能 的 唯一 途径 是 ， 返 回 一 个 通过 调用 
super.clone 而 得 到 的 对 象 。 如 果 clone 方法 
BES AMOR, CMs BIA 
错误 的 类 。 因 此 ， MR SAF fina 类 
中 的 clone Waban 则 应 该 返回 一 个 通过 调用 
super.clone 而 得 到 的 对 象 o 如 果 类 的 所 有 
超 类 都 遵守 这 条 规则 ， 那么 调用 super.clone 
最 终 会 调用 Object 的 clone Fie, 从 而 创建 
出 正确 类 的 实例 。 这 种 机 制 大 体 上 类 似 于 自 
i ee 


从 1.6 发 行 版 本 开始 ， cloneable 接口 并 没有 
清楚 地 指明 ， 一 个 类 在 实现 这 个 接口 时 应 该 
承担 哪些 责任 。 实际 上 ， 对 于 实现 了 
Cloneable 的 类 ， 我 们 总 是 期 望 它 提供 一 个 
功能 适当 的 公有 的 cioe 方法 。 通 常情 况 
下 ， 除 非 该 类 的 所 有 超 类 都 提供 了 行为 民 好 
的 clone 实现 ， 无 论 是 公有 的 还 是 受 保护 
的 ， 人 否则 ， 都 不 可 能 这 么 做 。 


假设 你 希望 在 一 个 类 中 实现 Cloneable ; 并 
且 它 的 超 类 都 提供 行为 良好 的 clone 方法 。 
你 从 super.cione() 中 得 到 的 对 象 可 能 会 接近 
于 最 终 要 返回 的 对 象 ， 也 可 能 相差 其 远 ， 这 

















要 取决 于 这 个 类 的 本 质 。 从 每 个 超 类 的 角度 
来 看 ， 这 个 对 象 僵尸 原始 对 象 功能 完整 的 页 
隆 (dlone)〉。 在 这 个 类 中 声明 的 域 (如 果 有 
的 话 ) 将 等 同 于 被 克隆 对 象 中 相应 的 域 。 如 
果 每 个 域 包 含 一 个 基本 类 型 的 值 ， 或 者 包 合 
一 个 指 加 不 可 变 对 象 的 引用 ， 那 么 被 返回 对 
象 则 可 能 正 是 你 所 需要 的 对 象 ， 在 这 种 情况 
下 不 需要 再 做 进一步 处 理 。 例 如 ， 第 9 条 中 
的 PhoneNumber 类 正 是 如 此 。 在 这 种 情况 下 ， 
你 所 需要 做 的 ’ 除了 声明 实现 了 Cloneable 
之 外 ， 就 是 对 Object 中 受 保护 的 clone 方法 
提供 公有 的 访问 途径 : 


@Override public PhoneNumber clone () { 








try Et 
return (PhoneNumber) super .clone(); 
} catch (CloneNotSupportedException e) { 


throw new AssertionError(); 
// Can't happen 


} 
} 


注意 上 述 的 clone 方法 返回 的 是 PhoneNumber 
， 而 不 是 object 。 从 Java 1.5 发 行 版 本 开 
台 ， 这 么 做 是 合法 的 ， 也 是 我 们 所 期 待 的 ， 
因为 1.5 发 行 版 本 中 引入 了 协 变 返回 类 型 
(covariant return type) 作为 泛 型 。 换 名 话 
说 ， 目 前 履 盖 方法 的 返回 类 型 可 以 是 被 覆 兰 
方法 的 返回 类 型 的 子 类 了 。 这 样 有 助 于 敌 盖 
方法 提供 更 多 关于 被 返回 对 象 的 信息 ， 并 且 
在 客户 端 中 不 必 进 行 转换 。 由 于 object.clone 
返回 Object  ， PhoneNumber .clone 必须 在 返回 
super .clone() 的 结果 之 前 将 它 转换 。 这 里 提 
现 了 一 条 通则 : 永远 不 要 让 客户 去 做 任何 类 
库 能 够 蕉 客户 完成 的 事情 。 











如 有 果 对 象 中 包含 的 域 引用 了 可 变 的 对 象 ， 使 
用 上 述 这 种 简单 的 clone 实现 可 能 会 导致 灾 
难 性 的 捕杀 。 例如 ， 考 虑 第 6 条 中 的 stack 


K: 


public class Stack { 
private Object[] elements; 
private int size = 0; 


private static final int 
DEFAULT_INITIAL_CAPACITY = 16 ; 


public Stack () { 


this .elements = new 
Object [DEFAULT_INITIAL_CAPACITY]; 


} 


public void push (Object e) { 
ensureCapacity(); 


elements[size++] = e; 


public Object pop () £ 
if (size =m ) 


throw new 
EmptyStackException(); 


Object result = elements[--size]; 


elements[size] = null ; 
// Eliminate obsolete reference 


return result; 


// Ensure space for at least one more element. 


private void ensureCapacity () { 


if (elements.length == size) 


elements = Arrays.copyOf(elements, 
2 E size jr 


} 


假设 你 希望 把 这 个 类 做 成 可 克隆 的 
(cloneable〉。 如 果 它 的 cione 方法 仅 
仪 返回 super.clone() ， 这 样 得 到 的 
Stack 实例 ， 在 其 size 域 中 具有 正确 
的 值 ， 但 是 它 的 elements 域 将 引用 与 原 
始 stack 实例 相同 的 数组 。 修 改 原始 的 
实例 会 破坏 被 克隆 对 象 中 的 约束 条 件 ， 
反之 亦 然 。 很 快 你 就 会 发 现 ， 这 个 程序 
将 产生 毫 无 意义 的 结 末 ， 或 者 抛 出 


NullPointerException Jf rf o 


如 果 调 用 Stack 类 中 唯一 的 构造 器 ， 1x 
种 情况 就 永远 不 会 发 生 。 实际 上 ， 
clone FTE RE PSE AB 你 必须 
确保 它 不 会 伤害 到 原始 的 对 象 ， 并 确保 
正确 地 创建 被 克隆 对 象 中 的 约束 条 件 
Cinvariaant) 。 为 了 使 stack 类 中 的 
clone 方法 正常 地 工作 ， 它 必 须要 拷贝 
栈 的 内 部 信息 。 最 容易 的 做 法 是 ， 在 
elements 数 组 中 递归 的 调用 clone 3: 


@Override public Stack clone () { 





try BA 


Stack result = (Stack) super 
-clone(); 


result.elements = elements.clone(); 
return result; 


catch 
(CloneNotSupportedException e) { 


throw new AssertionError(); 


} 


注意 ， 我 们 不 一 定 要 将 elements. clone) 
的 结果 转换 成 object[] 。 自 Java 1.5 发 
行 版 本 起 ， 在 数组 上 调用 clone 返回 的 
数组 ， 其 编译 时 类 异己 被 殉 隆 数组 的 类 
型 相同 。 


还 要 注意 ， 如 果 elements 域 是 final 
的 ， 上 述 方案 区 不 能 正常 工作 ， 因 为 
clone 方法 是 被 禁止 给 elements 域 赋 新 
值 的 。 这 有 是 个 根本 的 问题 : clone IW 
与 引用 可 变 对 象 的 rina 域 的 正常 用 法 
是 不 相 兼 容 的 ， 除 非 在 原始 对 象 和 页 
隆 对 象 之 间 可 以 安全 地 共享 此 可 变 对 
象 。 为 了 使 类 成 为 可 克隆 的 ， 可 能 有 必 
要 从 某 些 域 中 去 挥 tinal (BUTT o 


递归 地 调用 cioe 有 时 还 不 够 。 例 如 ， 
假设 你 正在 为 一 个 散 列 表 编 写 clone 方 
法 ， 它 的 内 部 数据 包含 一 个 散 列 通 数 

组 ， 每 个 散 列 通 都 指向 “ 键 一 一 值 ” 对 链 
表 的 第 一 个 项 ， 如 果 桶 是 空 的 ， 则 为 

null o 出 于 性 能 方面 的 考虑 ， 该 类 实 
现 了 它 自己 的 轻 量 级 单 同 链表 ， 而 没有 
使 用 Java 内 部 的 java.util.LinkedList o 1% 
类 如 下 : 


public class HashTable implements 
Cloneable { 








private Entry[] buckets = ...; 
private static class Entry { 
final Object key; 
Object value; 


Entry next; 


Entry(Object key, Object value, Entry next) { 
this .key = key; 
this .value = value; 


this .next = next; 


// Remainder omitted 





假设 你 仅仅 递归 地 克隆 这 个 散 列 桶 数 
组 ， 就 像 我 们 对 stack 类 所 做 的 那样 : 
// Broken - results in shared internal state! 


@Override public HashTable clone () 


try Bi 


HashTable result = (HashTable) 
super .clone(); 


result.buckets = buckets.clone(); 
return result; 


} catch 
(CloneNotSupportedException e) { 


throw new AssertionError(); 





里 然 补 克隆 对 象 有 它 自 己 的 散 列 桶 数 
组 ， 但 是 ， 这 个 数组 引用 的 链表 与 原始 
对 象 是 一 样 的 ， 从 而 很 容易 引起 克隆 对 
象 和 原始 对 象 中 不 确定 的 行为 。 为 了 修 
正 这 个 问题 ， 必 须 单独 地 拷贝 并 组 成 每 
个 桶 的 链表 。 下 面 是 一 种 第 见 的 做 法 : 


public class HashTable implements 


Cloneable { 
private Entry[] buckets = ...; 
private static class Entry { 
final Object key; 
Object value; 


Entry next; 


Entry(Object key, Object value, Entry next) { 
this .key = key; 


this .value = value; 


this .next = next; 


// Recursively copy the linked list headed by this entry 
Entry deepCopy () { 


return new 
Entry(key, value, 


next == null ? null 
next.deepCopy()); 


} 


@Override public HashTable clone 
O i 


try { 


HashTable result = (HashTable) 
super .clone(); 


result.buckets = new 
Entry[buckets.length]; 
for ( int i= 0 
; i < buckets.length; i++) 
if (buckets[i] != null 


result.buckets[i] = buckets[i].deepc 


return result; 


catch 
(CloneNotSupportedException e) { 


throw new 
AssertionError(); 


} 


// Remainder omitted 


私有 类 HashTable.Entry 被 加 强 了 ， 
它 文 持 一 个 “深度 拷贝 (deep 
copy) i HashTable 上 的 
clone 方法 分 配 了 一 个 大 小 适中 
的 、 新 的 buckets 数组 ， F A ata 
原始 的 buckets 数组 ， 对 本 一 个 中 
空 散 列 桶 进行 深度 找 贝 。 Entry 类 
中 的 深度 找 贝 方法 递归 地 调用 它 自 
号 ， 以 便 拷 贝 整个 链表 〈 它 是 链表 
的 头绪 点) 。 虽 然 这 种 方法 很 灵 
活 ， 如 果 散 列 桶 不 是 很 长 的 话 ， 也 
会 工作 得 很 好 ， 但 是 ， 这 样 殉 隆 一 
个 链表 并 不 是 一 个 好 方法 ， 因 为 针 
对 列表 中 的 每 个 元 系 ， 它 都 要 消耗 
一 端 栈 空 间 。 如 果 链 表 比 较 长 ， 这 
很 容易 导致 栈 溢出 。 为 了 避免 发 生 
这 种 情况 ， 你 可 以 在 deepcopy 中 用 
和 迭代 Citeration) 代替 递归 


(recursion) : 











// Iteratively copy the linked list headed by this Ent 
Entry deepCopy () { 


Entry result = new 
Entry(key, value, next); 


for 
(Entry p = result; p.next != null 
; p = p.next) 


p.next = new 
Entry(p.next.key, p.next.value, p.next.next); 


return result; 


} 


克隆 复杂 对 象 的 最 后 一 种 办 法 是 ， 
先 调 用 super.clone ， 然后 把 结果 对 
象 中 的 所 有 域 都 设置 为 它们 的 空白 
状态 (virgin state) ， 然 后 调用 高 
层 Chigher-level) 的 方法 来 重新 产 
生 对 象 的 状态 。 在 我 们 的 HashTable 
例子 中 ， buckets 域 将 被 初始 化 为 
一 个 新 的 散 列 桶 数组 ， 然 后 ， 对 于 
正在 被 克隆 的 散 列 表 中 的 每 一 个 键 
一 一 值 映射 ， 都 调用 put(key, value) 
方法 〈 上 面 没有 给 出 其 代码 ) 。 这 
种 做 法 往往 会 产生 一 个 简单 、 合 理 
且 相 当 优 美的 clone 方法 ， 但 是 它 
运行 起 来 通常 没有 “直接 操作 对 象 
及 其 元 隆 对 象 的 内 部 状态 的 clone 


如 同 构造 器 一 样 ， clone 方法 不 应 
该 在 构造 的 过 程 中 ， 调 用 新 对 象 中 
任何 非 final 的 方法 〈 见 第 17 

条 ) o WR cione 调用 了 一 个 被 覆 
盖 的 方法 ， 那 么 在 该 方法 所 在 的 子 
类 有 机 会 修正 它 在 克隆 对 象 中 的 状 
态 之 前 ， 该 方法 就 会 先 被 执行 ， 这 
样 很 有 可 能 会 导致 克隆 对 象 和 原始 
对 象 之 间 的 不 一 致 。 国 此 ， 上 一 段 
沙 中 讨论 到 的 put(key，value) 方法 
应 该 要 么 是 tin 的 ， 要 么 是 私有 

















的 (如 果 是 私有 的 ， 它 应 该 算是 非 
final 公有 方法 的 “辅助 方法 [helper 
method]”) 。 


Object 的 clone 方法 被 声明 为 可 抛 
出 CloneNotSupportedException 异常 ， 
但 是 ， B REH clone 方法 可 能 
会 忽略 这 个 声明 。 公有 的 clone Wag 
法 应 该 省 略 这 个 声明 ， 因 为 不 会 抛 
出 受 检 异 常 (checked exception) 

的 方法 与 会 抛 出 异常 的 方法 想必 ， 
使 用 起 来 更 加 轻松 〈 见 第 59 条 ) 。 
如 果 专 门 为 了 继承 而 设计 的 类 [ 见 
BATA Ve me S clone a Ta ati 
版 本 的 clone 方法 就 应 该 模拟 
Object.clone 的 行为 : 它 应 该 被 声 
明 为 protected 、 抛 出 
CloneNotSupportedException 异常 ， 并 
且 该 类 不 应 该 实现 Cloneable 接 
口 。 这 样 做 可 以 使 子 类 具有 实现 或 
者 不 实现 Cloneable 接口 的 自由 ， 
oo a 




















还 有 一 点 值得 注意 。 如 果 你 决定 用 
线程 安全 的 类 实现 Cloneable 接 
HO, 要 记得 它 的 clone 方法 必须 得 
到 很 好 的 同步 ， 就 像 任何 其 他 方法 
一 样 ( 见 第 66 条 ) o Object 的 
clone 方法 没有 同步 ， 因此 即使 很 
满意 ， 可 能 也 必须 编写 同步 的 
clone 方法 来 调用 Super .clone o 


简 而 言 之 ， 所 有 实现 了 Cloneable 

接口 的 类 都 应 该 用 一 个 公有 的 方法 
7 a clone o 此 公有 方法 首先 调用 
super.clone ， 然后 修正 任何 需要 修 


正 的 域 。 一 般 情 况 下 ， 这 意味 着 要 
拷贝 任何 包含 内 部 “深层 结构 ”的 可 
变 对 象 ， 并 用 指 加 新 对 象 的 引用 代 
蔡 原 来 指向 这 些 对 象 的 引用 。 虽 

然 ， 这 些 内 部 拷贝 操作 往往 可 以 通 
过 递归 地 调用 clone 来 完成 ， 但 这 
通常 并 不 是 最 佳 方法 。 如 果 该 类 只 
包含 基本 类 型 的 域 ， 或 者 指 同 不 可 
变 对 象 的 引用 ， 那 么 多 半 的 情况 是 
没有 域 需要 修正 。 这 条 规则 也 有 例 
外 ， 壁 如， 代表 序号 或 者 其 他 唯一 
ID 值 的 域 ， 或 者 代表 对 象 的 创建 时 
间 的 域 ， 不 管 这 些 域 是 基本 类 型 还 
ee Nai eae 














真 的 有 必要 这 么 复杂 吗 ? 很 少 有 这 
种 必要 。 如 果 你 扩展 一 个 实现 
Cloneable 接 口 的 类 ， 那么 你 除 T 
实现 一 个 行为 良好 的 cione 方法 
Sh, VAAN. AM, 最 好 提 
供 茶 些 其 他 的 途径 来 代 蔡 对 象 捞 
贝 ， 或 者 干脆 不 提供 这 样 的 功能 

。 例 如 ， 对 于 不 可 变 类 ， 文 持 对 象 
拷贝 并 没有 太 大 的 意义 ， 因 为 被 找 
A en eatery 





男 一 个 实现 对 象 拷贝 的 好 办 法 是 提 
供 一 个 找 贝 构造 器 Ccopy 
constructor) 或 拷贝 工厂 Ccopy 
factory) 。 找 贝 构造 器 只 是 一 个 构 
造 器 ， 它 唯一 的 参数 类 型 是 包含 该 
构造 器 的 类 ， 例 如 : 


public Yum (Yum yum) ; 





EUI ERKUT AE as 
态 工厂 : 


public static Yum newInstance 
(Yum yum) ; 


找 贝 构造 器 的 做 法 ， 及 其 静态 工厂 
FE 的 变性 ， 都 比 Cloneable/clone 
方法 具有 更 多 的 优势 : 它们 不 依赖 
于 某 一 种 很 有 风险 的 、 语 言 之 外 的 
对 象 创 建 机 制 ， 它们 不 要 求 遵守 尚 
未 制定 好 文档 的 规范 ;它们 不 会 与 
final 域 的 正常 使 用 发 生 冲 突 ; 它 
们 不 会 抛 出 不 必要 的 受 检 腊 第 
(checked exception) ; 它们 不 需 
要 进行 类 型 转换 。 虽 然 你 不 可 能 把 
拷贝 构造 器 或 者 静态 工厂 放 到 接口 
中 ， 但 是 由 于 Cloneable 接口 缺少 
一 个 公有 的 clone J 所 以 它 也 
没有 提供 一 个 接口 该 有 的 功能 

此 ， 使 用 拷贝 构造 器 或 者 找 贝 工厂 
来 代替 clone 方法 时 ， 并 没有 放弃 
接口 的 功能 特性 。 


更 进一步 ， 找 贝 构造 器 或 者 找 贝 工 
程 可 以 带 一 个 参数 ， 参 数 类 型 是 通 
过 该 类 实现 的 接口 。 例 如 ， 按 照 惯 
例 ， 所 有 通用 集合 实现 都 提供 了 一 
个 拷贝 构造 器 ， 它 的 参数 类 型 为 
Collection 或 者 Map 。 基 于 接口 的 
拷贝 构造 器 和 拷贝 工厂 (更 准确 的 
叫 法 应 该 是 “转换 构造 器 
(conversion constructor) ”和 和 转换 
工厂 (conversion fatory) ) ， 人 允许 
客户 选择 找 见 的 实现 类 型 ， 而 不 是 
E aay eae 例 
加， 假设 你 A HashSet  ， 并 且 
希望 把 它 拷贝 成 一 TreeSet o 





clone 方法 无 法 提供 这 样 的 功 能 ’ 
但 是 用 转换 构造 器 很 容易 实现 : 


new TreeSet(s) oœ 


既然 Cloneable 接口 具有 上 诉 那 么 
多 问题 ， 可 以 肯定 地 说 ， 其 他 的 接 
口 都 不 应 该 扩展 Cextend) 这 个 接 
口 ， 为 了 继承 而 设计 的 类 〈 见 第 17 
条 ) 也 不 应 该 实现 (implement) 
这 个 接口 。 由 于 它 具 有 这 么 多 的 缺 
点 ， 有 些 专 家 级 的 程序 员 干 脆 从 来 
DER hi clone 方法 ， 也 从 来 不 去 
调用 它 ， 除 非 揽 贝 数组 。 你 必须 清 
楚 一 点 ， 对 于 一 个 专门 为 了 继承 而 
设计 的 类 ， 如 果 你 未 能 提供 行为 良 
好 的 受 保护 的 (protected) clone 
THE, EWS FARA FT ESE HL 
Cloneable 接口 。 





第 12 条 : 考虑 实现 Comparable 接口 


与 本 章 中 讨论 的 其 他 方法 不 同 ， conparere 方法 并 没有 在 object 中 声 
明 。 相反 ， 它 是 Comparable 接口 中 唯一 的 方法 。 compareTo 方法 不 但 允许 
进行 简单 的 等 同行 比较 ， 而 且 允 许 执行 顺序 比较 ， 除 此 之 外 ， 它 与 
Object 的 equals 方法 具有 相似 的 特征 ， 它 还 是 个 泛 型 。 类 实现 了 
Comparable 接口 ， 束 表 明 它 的 实例 具有 内 在 的 排序 关系 Cnatural 
ordering) 。 为 实现 Comparable 接口 的 对 象 数组 进行 排序 就 这 么 简单 : 


Arrays.sort(a); 





对 存储 在 集合 中 的 comparable 对 象 进行 搜索 、 计 算 极限 值 以 及 目 动 维护 
也 同样 简单 。 例 如 ， 下 面 的 程序 依赖 于 string 实现 了 comparaie 接口， 
它 去 掉 了 命令 行 参数 列表 中 的 重复 参数 ， 并 按 字 母 顺 序 打 印 出 来 : 
public class WordList { 
public static void main (String[] args) { 
Set<String> s = new TreeSet<String>(); 
Collections.addAll(s, args); 


System.out.printin(s); 


} 


一 旦 类 实现 了 Comparable 接口 ， 它 就 可 以 跟 许 多 泛 型 算法 (generic 
algorithm) 以 及 依赖 于 该 接口 的 集合 实现 〈collection implementation) 
进行 写作 。 你 付出 很 小 的 努力 束 可 以 获得 非常 强大 的 功能 。 事 实 上 ， 
Java 平 台 类 库 中 的 所 有 值 类 (value classes) 都 实现 了 comparable 接口 。 
如 有 果 你 正在 编写 一 个 值 类 ， 它 具有 非常 明显 的 内 在 排序 关系 ， 比 如 按 字 
母 排序 、 按 数值 顺序 或 者 按 年 代 顺 序 ， 那 你 就 应 该 坚决 考虑 实现 这 个 接 
O: 














public interface Comparable < T> { 


int compareTo (T t) ; 


compareTo 方法 的 通 用 用 约定 与 equals 方法 的 相似 : 


将 这 个 对 象 与 指定 的 对 象 进行 比 较 。 当 该 对 象 小 于 、 等 于 或 大 于 指定 对 
象 的 时 候 ， 分 别 返 回 一 个 负 整 数 、 零 或 者 正 整数 。 如 采 和 由 于 指定 对 象 的 
类 型 而 无 法 与 该 对 象 进行 比 较 ， 则 抛 出 ClassCastException 异常 。 


在 下 面 的 说 明 中 ， 符号 sgn (表达 式 ) 表示 数学 中 的 signum 函数 ， 它 
根据 表达 式 Cexpression) 的 值 为 负 值 、 零 和 正 值 ， 分 别 返回 -1、0 或 1。 


。 实现 者 必须 确保 所 有 的 x 和 y 都 满足 sgn(x.compareTo(y) == - 
sgn(y.compareTo(x))) œo (这 也 暗示 着 ， ae y.compareTo(x) HO ty FE 
常 时 ， x.compareTo(y) 才 必 须 抛 出 异 

实现 者 还 DAUM LER RT REED. x.compareTo(y) > 9 && 
y.compareTo(z) > 0 暗示 着 x.compareTo(z) >0 o 

最 后 ， 实 现 者 必须 确保 x.compareTo(y) == 0 上 暗示 着 所 有 的 2 都 满足 
sgn(x.compareTo(z)) == sgn(y.compareTo(z)) œ 

强烈 建议 (x.compareTo(y) == 0) == (x.equals(y)) > 但 这 并 非 绝 对 必要 
一 般 说 来 ， 任 何 实现 了 comparable 接口 的 类 ， 大 违反 了 这 个 条 件 ， 
都 应 该 明确 予以 说 明 。 推 荐 使 用 这 样 的 说 法 :“ 注 意 ， 该 类 具有 内 
在 的 排序 功能 ， 但 是 与 equals 不 一 致 。” 


二 万 不 要 被 上 述 约定 中 的 数学 关系 所 迷惑 。 如 同 eqvals 约定 〈 见 第 8 

条 ) 一 样 ， comparere 约定 并 没有 它 看 起 来 的 那么 复杂 。 在 类 的 内 部 ， 

任何 合理 的 顺序 关系 都 可 以 满足 compareto 约定 。 与 equals 不 同 的 是 ， 
在 跨越 不 同类 的 时 候 ， comparer。 可 以 不 做 比较 : 如 果 两 个 被 比较 的 对 
象 引 用 不 同类 的 对 象 ， compareTo 可 以 抛 出 ClassCastException 异常 。 通 
常 ， 这 正 是 compareto 在 这 种 情况 下 应 该 做 的 事情 ， 如 果 类 设置 了 正确 
的 参数 ， 这 也 正 是 它 所 要 做 的 事情 。 虽 然 以 上 约定 并 没有 把 跨 类 之 间 的 
比较 排除 在 外 ， 但 是 从 Java 1.6 发 行 版 本 开始 ，Java 平 台 类 库 中 残 没 有 哪 
个 类 有 文 持 这 种 特性 了 。 


WITREN S nashcoue 约定 的 类 会 破坏 其 他 依赖 于 散 列 做 法 的 类 一 样 ， 
违反 compareto 约定 的 类 也 会 破坏 其 他 依赖 于 比较 关系 的 类 。 依 赖 于 比 
较 关 系 的 类 包括 有 序 集合 类 Treeset 和 TreeMap ， 以 及 工具 类 Collections 
和 arrays ， 它 们 内 部 包含 有 搜索 和 排序 算法 。 


现在 我 们 来 回顾 一 下 compareto ARE PAAR. BATH, AOR AUG 
了 两 个 对 象 引 用 之 间 的 比较 方 回 ， 就 会 发 生 下 面 的 情况 ， 如 果 第 一 个 对 





























象 小 于 第 二 个 对 象 ， 则 第 二 个 对 象 一 定 大 于 第 一 个 对 象 ; 如 果 第 一 个 对 
象 等 于 第 二 个 对 象 ， 则 第 二 个 对 象 一 定 等 于 第 一 个 对 象 ;， 如 果 第 一 个 对 
象 大 于 第 二 个 对 象 ， 则 第 二 个 对 象 一 定 小 于 第 一 个 对 象 。 第 二 条 指出 ， 
如 果 一 个 对 象 大 于 第 二 个 对 象 ， 并 且 第 二 个 对 象 义 大 于 第 三 个 对 象 ， 那 
么 第 一 个 对 象 一 定 大 于 第 三 个 对 象 。 最 后 一 条 指出 ， 在 比较 时 被 认为 相 
等 的 所 有 对 象 ， 它 们 跟 别 的 对 象 做 比较 时 一 定 会 产生 同样 的 结果 。 


这 三 个 条 球 的 一 个 直接 结果 是 ， 由 comparer。 方 法 施加 的 等 同性 测试 
(equality set) ， 也 一 定 遵守 相同 于 equals 约定 所 施加 的 限制 条 件 : A 
有 反 性 、 对 称 性 和 传递 性 。 因 此 ， 下 面 的 告诫 也 同样 试用 : 无 法 在 用 新 的 
值 组 件 扩 展 可 实例 化 的 类 时 ， 同 时 保持 comparer。 约 定 ， 除 非 愿意 放弃 
面向 对 象 的 抽象 优势 〈 见 第 8 条 ) 。 针 对 equals 的 权益 之 计 也 同样 适用 
于 compareTo 方法 。 如 果 你 想 为 一 个 实现 了 Comparable fe ASS DIE E 
件 ， 请 不 要 扩展 这 个 类 ; 而 是 要 编写 一 个 不 相关 的 类 ， 其 中 包含 第 一 个 
类 的 一 个 实例 。 然 后 提供 一 个 “视图 (view) "方法 返回 这 个 实例 。 这 样 
既 可 以 让 你 自由 地 在 第 二 个 类 上 实现 comparere 方法 ， 同 时 也 人 允许 它 的 
客户 端 在 必要 的 时 候 ， 把 第 二 个 类 的 实例 视 同 第 一 个 类 的 实例 。 


compareTo 约定 的 最 后 把 是 -个 强烈 的 建议 ， 而 不 是 真正 的 规则 ， 只 
是 说 明了 compareto 方法 施加 的 等 同性 测试 ， 在 通常 情况 下 应 该 返回 与 
equals 方法 同样 的 结果 。 如 果 遵 守 了 这 一 条 ， 那 么 由 comparer。 方 法 所 
施加 的 顺序 关系 就 被 认为 “与 equals = (consistent with equals ) ”。 
如 果 违 反 了 这 条 规则 ， 顺 序 关 系 就 被 认为 “ 与 equals 不 一 致 
(inconsistent with equals JJ 如 果 一 个 类 的 compareTo 方法 施加 了 一 
个 与 equas 方法 不 一 致 的 顺序 关系 ， 它 仍然 能 够 正常 工作 ， 但 是 ， 如 
果 一 个 有 序 集合 (sorted collection) 包含 了 该 类 的 元 素 ， 这 个 集合 就 可 
能 无 法 遵守 相应 结合 接口 ( collection 、 set 或 Map ) 的 通用 约定 。 a5 
是 因为 ， 对 于 这 些 接口 的 通用 约定 是 按照 equals 方法 来 定义 的 ， 但 是 
有 序 集合 使 用 了 由 compareto 方法 而 不 是 equars 方法 所 施加 的 等 同性 测 
试 。 尽 管 出 现 这 种 情况 不 会 造成 灾难 性 的 后 果 ， 但 是 应 该 有 所 了 解 。 


例如 ， 考虑 BigDecimal 类 ， 它 的 compareTo 方法 与 equals 不 一 致 。 如 果 
你 创建 了 一 个 HashSet 实例 ， 并 且 添 加 new BigDecimal("1.0") 和 new 

BigDecimal("1.0") > eae 合 吏 将 包含 两 个 元 素 ， 因为 新 增 到 集合 中 的 两 
个 Bigpecinal 实例 ， 通 过 equals 方法 来 比较 时 是 不 相等 的 。 然 而 ， 如 果 
你 使 用 rreeset 而 不 是 nashset 来 执行 同样 的 过 程 ， 集 合 中 将 只 包含 一 人 1 
JDR 因为 这 两 个 BigDecimal 实例 在 通过 compareTo 方法 进行 比较 时 是 模 









































So CHE bY sigvecima 的 文档 。) 


编写 compareTo 方法 与 编写 equals 方法 非常 相似 ， 但 也 存在 几 处 重大 的 
差别 。 因为 Comparable 接口 是 参数 化 的 ， mE. comparable 方法 是 静态 的 
类 型 ， 因 此 不 必 进 行 类 型 检查 ， 也 不 必 对 它 的 参数 进行 转型 。 如 打 参 数 
的 类 型 不 合适 ， 这 个 调用 甚至 无 法 编译 。 如 果 参 数 为 nl ， 这 个 调用 
应 该 抛 出 NullPointerException HT: 并 日 一 旦 该 方法 试图 访问 它 的 成 员 
时 就 应 该 抛 出 。 


comparero 方法 中 域 的 比较 是 有 顺序 的 比较 ， 而 不 是 等 同性 的 比较 。 比 
较 对 象 引 用 域 可 以 是 递归 地 调用 comparero 方法 来 实现 。 如 果 一 个 域 并 
没有 实现 Comparable 接口 ， 或 者 你 需要 使 用 一 个 非 标准 的 排序 关系 ， 就 
可 以 使 用 一 个 显 式 的 Comparator 来 代替 。 或 者 编写 自己 的 Comparator + 

或 者 使 用 己 有 的 Comparator + 璧 如 针对 第 8 条 中 CaseInsensitiveString 类 的 
这 个 compareTo 方法 使 用 一 个 已 有 的 Comparator 


public final class CaseInsensitiveString 





implements Comparable < CaseInsensitiveString > { 
public int compareTo (CaseInsensitiveString cis) { 


return String.CASE_INSENSITIVE_ORDER.compare(s, cis.s); 


// Remainder omitted 


注意 CaseInsensitiveString 类 实现 了 Comparable<CaseInsensitiveString> 接口 。 
由 此 可 见 ， CaseInsensitiveString 引 用 只 能 与 其 他 的 
Comparable<CaseInsensitiveString> 5] 用 进行 比较 。 在 声 明 类 去 实现 

Comparable 接口 时 ， 这 是 常用 的 模式 。 还 要 注意 compareTo 方法 的 参数 是 
CaseInsensitiveString ， 而 不 是 Object ， 这 是 上 述 的 类 声明 所 要 求 的 。 


比较 整数 型 基本 类 型 的 域 ， 可 以 使 用 关系 操作 符 < 和 > 。 例 如 ， 浮 点 
域 用 Double.compare 或 者 Float.compare +; 而 不 用 关系 操作 符 ， 当 应 用 到 浮 
点 值 时 ， 它 们 没有 遵守 compareto 的 通用 约定 。 对 于 数组 ， 则 要 把 这 些 
指导 原则 应 用 到 每 个 元 素 上 。 


如 有 果 一 个 类 有 多 个 关键 域 ， 那 么 ， 按 照 什么 样 的 顺序 来 比较 这 些 域 是 非 














常 天 键 的 。 你 必须 从 最 关键 的 域 开 始 ， 逐 步 进行 到 所 有 的 重要 域 。 如 果 
某 个 域 的 比较 产生 了 非 零 的 结果 (和 零 代 表 相 等 ) ， 则 整个 比较 操作 结 

束 ， 并 返回 该 结果 。 如 果 最 关键 的 域 是 相等 的 ， 则 进一步 比较 次 最 关键 
的 域 ， 以 此 类 推 。 如 果 所 有 的 域 都 是 相等 的 ， 则 对 象 就 是 相等 的 ， 并 返 








[al & 下 面 通过 第 9 条 中 的 PhoneNumber 类 的 compareTo 方法 来 说 明 这 种 方 


public 
// 
if 


If 


// 


时 让 


if 


// 


if 


af 


int compareTo (PhoneNumber pn) { 


Compare area codes 


(areaCode < pn.areaCode) 
return - 1; 
(areaCode > pn.areaCode) 


return 1; 


Area codes are equal, compare prefixes 


(prefix < pn.prefix) 
return - 1 ; 
(prefix > pn.prefix) 


return 1; 


Area codes and prefixes are equal, compare line numbers 


(lineNumber < pn.lineNumber ) 
return - 1; 
(lineNumber > pn.lineNumber ) 


return 1; 


return ©; // All fields are equal 





里 然 这 个 方法 可 行 ， 但 它 还 可 以 进行 改进 。 回 想 一 下 ， compareto 方法 
的 约定 并 没有 指定 返回 值 的 大 小 magnitude) ， 而 只 是 指定 了 返回 值 


的 符号 。 


public 


你 可 以 利用 这 一 点 来 简化 代码 ， 或 许 还 能 提高 它 的 运行 速度 : 


int compareTo (PhoneNumber pn) { 


// Compare area codes 
int areaCodeDiff = areaCode - pn.areaCode; 
if (areaCodeDiff != 0 ) 


return areaCodeDiff; 


// Area codes are equal, compare prefixes 
int prefixDiff = prefix - pn.prefix; 
if (prefixDiff != 0 ) 


return prefixDiff; 


// Area codes and prefixes are equal, compare line numbers 


return lineNumber - pn.lineNumber; 


这 项 技巧 在 这 里 能 够 工作 得 很 好 ， 但 是 用 起 来 要 非常 小 心 。 除 非 你 确信 
相关 的 域 不 会 为 负 值 ， 或 者 更 一 般 的 情况 : 最 小 和 最 大 的 可 能 域 值 之 差 
小 于 或 等 于 antecer.max_vacue ($2^{23}-1$)， 奋 则 束 不 要 使 用 这 种 方法 。 

这 项 技巧 有 时 不 能 正常 工作 的 原因 在 于 ， 一 个 有 符号 的 32 位 的 整数 还 没 
有 大 道 足 以 表达 任意 两 个 32 位 整数 的 差 。 如 果 i 是 一 个 很 大 的 正 整数 
( int 类 型 ) ， 而 j 是 一 个 很 大 的 负 整 数 ( int 类 型 ) ， 那 么 G- j 
将 会 洪 出 ， 并 返回 一 个 负 值 。 这 样 就 使 得 comparere 方法 将 对 某 些 参数 
返回 错误 的 结果 ， 违 反 了 compareto 约定 的 第 一 条 和 第 二 条 。 这 不 是 一 

个 纯粹 的 理论 问题 ， 它 已 经 在 实际 的 系统 中 导致 了 失败 ， 这 些 失 败 可 能 
l a 因为 这 样 的 comparero DIAIR E BLA 4a AE Ab REE 
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第 4 章 类 和 接口 


类 和 接口 是 Java 程 序 设计 语言 的 核心 ， 它 们 也 是 Java 语 言 的 基本 抽象 单 
元 。Java 语 言 提供 了 许多 强大 的 基本 元 素 ， 供 程序 员 用 来 设计 类 和 接 
口 。 本 章 曾 述 的 一 些 指 导 原 则 ， 则 可 以 帮助 你 更 好 地 利用 这 些 元 素 ， 设 
计 出 更 加 有 用 、 健 壮 和 灵活 的 类 和 接口 。 








第 13 条 : 使 类 的 成 员 的 可 访问 性 最 小 
化 


要 区 别 设计 展 好 的 模块 与 设计 不 好 的 模块 ， 最 重要 的 因素 在 于 ， 这 个 模 
块 对 于 外 部 的 其 他 模块 而 言 ， 是 否 隐 藏 其 内 部 数据 和 其 他 实现 细节 。 设 
计 展 好 的 模块 会 隐藏 所 有 的 实现 细节 ， 把 它 的 API 和 它 的 实现 清晰 地 隔 
离开 来 。 然 后 ， 模 块 之 间 只 通过 它们 的 API 进 行 通信 ， 一 个 模块 不 需要 
知道 其 他 模块 的 内 部 工作 情况 。 这 个 概念 被 称 为 信息 隐藏 (information 
hiding) 或 封装 Cencapsulation) ， 是 软件 设计 的 基本 原则 之 一 
[Parnas72]. 


言 恩 隐 藏 之 所 以 非常 重要 有 许多 原因 ， 其 中 大 多 数理 由 都 源 于 这 样 一 个 
事实 : 它 可 以 有 效 地 解除 组 成 系统 的 各 模块 之 间 的 耘 合 关系 ， 使 得 这 些 
模块 可 以 独立 地 开发 、 测 试 、 优 化 、 使 用 、 理 解 和 修改 。 这 样 可 以 加 快 
系统 开 友 的 速度 ， 因 为 这 些 模块 可 以 并 行 开 友 。 它 也 减轻 了 维护 的 负 
担 ， 因 为 程序 员 可 以 更 快 地 理解 这 些 模块 ， 并 且 在 调试 它们 的 时 候 可 以 
不 影响 其 他 的 模块 。 虽 然 信息 隐藏 本 里 无 论 是 对 内 还 是 对 外 ， 都 不 会 市 
来 更 好 的 性 能 ， 但 是 它 可 以 有 效 地 调节 性 能 : 一旦 完成 一 个 系统 ， 并 通 
过 剂 析 确 定 了 哪些 模块 影响 了 系统 的 性 能 〈 见 第 55 条 ) ， 那 些 模块 机 就 
可 以 被 进一步 优化 ， 而 不 会 影响 到 其 他 模块 的 正确 性 。 信 息 隐 藏 提高 
软件 的 可 重用 性 ， 因 为 模块 之 间 并 不 紧密 相连 ， 除 了 开发 这 些 模块 所 使 
用 的 环境 之 外 ， 它 们 在 其 他 的 环境 中 往往 也 很 有 用 。 最 后 ， 信 息 隐藏 也 
降低 了 构建 大 型 系统 的 风险 ， 因 为 即使 整个 系统 不 可 用 ， 但 是 这 些 独 立 
的 模块 却 有 可 能 是 可 用 的 。 


Java 程 序 设 计 语 言 提供 了 许多 机 制 〈facility) 来 协助 信息 隐藏 。 访问 控 
fil] Caccess acontrol) 机 制 [JLS，6.6] 决 定 了 类 、 接 口 和 成 员 的 可 访问 性 
(accessibility) 。 实 体 的 可 访问 性 是 由 该 实体 声明 所 在 的 位 置 ， 以 及 该 
实体 声明 中 所 出 现 的 访问 修饰 符 C private 、 protected 和 public ) HJ 
决定 的 。 正 确 地 使 用 这 些 修饰 符 对 于 实现 信息 隐藏 是 非常 关键 的 。 

第 一 规则 很 简单 : 尽 可 能 地 使 每 个 类 或 者 成 员 不 被 外 界 访问 。 换 句 话 
人 
访问 级 别 。 


XPH GEREK) 类 和 接口 ， 只 有 两 种 可 能 的 访问 级 别 : 包 级 私 






































有 的 Cpackage-private) 和 公有 的 (public) 。 如 果 你 用 pubiic 修饰 符 
声明 了 顶层 类 或 者 接口 ， 那 它 就 是 公有 的 ; 否则 ， 它 将 是 包 级 私有 的 。 
如 果 类 或 者 接口 能 够 被 做 成 包 级 私有 的 ， 它 就 应 该 被 做 成 包 级 私有 。 通 
过 把 类 或 者 接口 做 成 包 级 私有 ， 它 实际 上 成 了 这 个 包 的 实现 的 一 部 分 ， 
而 不 是 该 包 导 出 的 API 的 一 部 分 ， 在 以 后 的 发 行 版 本 中 ， 可 以 对 它 进行 
修改 、 蔡 换 ， 或 者 删除 ， 而 无 需 担 心 会 影响 到 现 有 的 客户 端 程序 。 如 果 
你 把 它 做 成 公有 的 ， 你 就 有 责任 永远 文 持 它 ， 以 保持 它们 的 兼容 性 。 


如 果 一 个 包 级 私有 的 项 层 类 (或 者 接口 ) 只 是 在 某 一 个 类 的 内 部 被 用 
到 ， 就 应 该 考虑 使 它 成 为 唯一 使 用 它 的 那个 类 的 私有 找 套 类 〈 见 第 22 
AR) 。 这 样 可 以 将 它 的 可 访问 范围 从 包 中 的 所 有 类 缩小 到 了 使 用 它 的 那 
个 类 。 然 而 ， 降 低 不 必要 公有 类 的 可 访问 性 ， 比 降低 包 级 私有 的 顶层 类 
的 更 重要 得 多 : 因为 公有 类 是 包 的 API 的 一 部 分 ， 而 包 级 私有 的 顶层 类 
则 已 经 是 这 个 包 的 实现 的 一 部 分 。 
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面 按照 可 访问 性 的 递增 顺序 罗列 出 来 : 


e 私有 的 (private) 只 有 在 声明 该 成 员 的 顶层 类 内 部 才 可 以 访 

问 这 个 成 员 。 

包 级 私有 的 〈package-private) 一 一 声明 该 成 员 的 包 内 部 的 任何 

类 都 可 以 访问 这 个 成 员 。 从 技术 上 讲 ， 它 被 称 为 “ 缺 省 (default) 

RE E E AR R 

别 。 

受 保护 的 《protected) 一 一 声明 该 成 员 的 子 类 可 以 访问 这 个 成 员 
(但 有 一 些 限 制 [JLS，6.6.2]) ， 并 且 ， 声 明 该 成 员 的 包 内 部 的 任 

何 类 也 可 以 访问 这 个 成 员 。 

e AAH (public) 一 一 在 任何 地 方 都 可 以 访问 该 成 员 。 


当 你 仔细 地 设计 了 类 的 公有 API 之 后 ， 可 能 觉得 应 该 把 所 有 其 他 的 成 员 
都 变 成 私有 的 。 其 实 ， 只 有 当 同 一 个 包 内 的 另 一 个 类 真正 需要 访问 一 个 
成 员 的 时 候 ， 你 才 应 该 删除 private 修饰 符 ， 使 该 成 员 编 程 包 级 私有 
的 。 如 果 你 发 现 目 己 经 党 要 做 这 样 的 的 事情 ， 就 应 该 重新 检查 你 的 系统 
设计 ， 看 看 是 否 另 一 种 分 解 方案 所 得 到 的 类 ， 与 其 他 类 之 间 的 耦合 度 会 
更 小 。 也 融 是 说 ， 私 有 成 员 和 包 级 私有 成 员 都 是 一 个 类 的 实现 中 的 一 部 
分 ， 一 般 不 会 影响 它 的 导出 的 API。 然 而 ， 如 果 这 个 类 实现 了 
Serializable 接 口 ( 见 第 74 和 75 条 ) ’ 这 些 域 就 有 可 能 会 被 “泄露 

deak) ”到 导出 的 API 中 。 















































对 于 公有 类 的 成 员 ， 当 访问 级 别 从 包 级 私有 编程 保护 级 别 是 ， 会 大 大 增 
强 可 访问 性 。 受 保护 的 成 员 时 类 的 导出 的 API 的 一 部 分 ， 必 须 永远 得 到 
支持 。 叶 出 的 类 的 受 保护 成 员 也 代表 了 该 类 对 于 茶 个 实现 细节 的 公开 承 
te BIR) 。 受 保护 的 成 员 应 该 尽量 少 用 。 


有 一 条 规则 限制 了 降低 方法 的 可 访问 性 的 能 力 。 如 果 方 法 上 覆盖 了 超 类 中 
的 一 个 方法 ， 子 类 中 的 访问 级 别 就 不 允许 低 于 超 类 中 的 访问 级 别 [UJLS， 

8.4.8.3]。 这 样 可 以 确保 任何 可 使 用 超 类 的 实例 的 地 方 也 都 可 以 使 用 子 类 
的 实例 。 如 果 你 违反 了 这 条 规则 ， 那 么 当 你 试图 编译 该 子 类 的 时 候 ， 编 
译 占 就 会 产生 一 条 错误 消息 。 这 条 规则 有 种 特殊 的 情形 : 如 果 一 个 类 实 
现 了 一 个 接口 ， 那 么 接口 中 所 有 的 类 方法 在 这 个 类 中 也 都 必须 被 声明 为 
公有 的 。 之 所 以 如 此 ， 是 因为 接口 中 所 有 方法 都 隐 含 着 公有 访问 级 别 

[JLS, 9.1.5]. 


为 了 便于 测试 ， 你 可 以 试 着 使 类 、 接 口 或 者 成 员 变 得 更 容易 访问 。 这 么 
做 在 一 定 程 度 上 来 说 是 好 的 。 为 了 测试 而 将 一 个 公有 类 的 私有 成 员 变 成 
包 级 私有 的 ， 这 还 可 以 接受 ,但 是 要 将 访问 级 别提 局 到 超过 它 ， 这 残 无 
法 接受 了 。 换 句 话 说 ， 不 能 为 了 测试 ， 而 将 类 、 接 口 或 者 成 员 变 成 包 的 
导出 的 API 的 一 部 分 。 幸 运 的 是 ， 也 没有 必要 这 么 做 ， 因 为 可 以 让 测试 
作为 被 测试 的 包 的 一 部 分 来 运行 ， 从 而 能 够 访问 它 的 包 级 私有 的 元 素 。 


实例 域 决 不 能 是 公有 的 〈 见 第 14 条 ) 。 如 果 域 是 非 final WY, 或 者 是 一 
个 指 同 可 变 对 象 的 final 引用 ， 那 么 一 旦 使 这 个 域 成 为 公有 的 ， 就 放弃 
了 对 存储 在 这 个 域 中 的 值 进行 限制 的 能 力 ;， 这 意味 着， 你 也 放弃 了 强制 
这 个 域 不 可 变 的 能 力 。 同 时 ， 妆 这 个 域 被 修改 的 时 候 ， 你 也 失去 了 对 它 
采取 任何 行动 的 能 力 。 因 此 ， 包含 公有 可 变 域 的 类 并 不 是 线程 安全 的 

。 即 使 域 是 final 的 ， 并 且 引 用 不 可 变 对 象 ， 当 把 这 个 域 编程 公有 的 时 
候 ， 也 就 放弃 了 “切换 到 一 种 新 的 内 部 数据 表示 法 ”的 灵活 性 。 


同样 的 建议 也 适用 于 表态 域 ， 只 是 有 一 种 例外 情况 。 假 设 币 量 构成 了 类 
提供 的 整个 抽象 中 的 一 部 分 ， 可 以 通过 公有 的 静态 final 域 来 暴露 这 些 
种 量 。 按 惯例 ， 这 种 域 的 名 称 由 大 写字 母 组 成 ， 单 词 之 间 用 下 划 线 隅 开 
〈 见 第 56 条 ) 。 很 重要 的 一 点 事 ， 这 些 域 要 么 包含 基本 类 型 的 值 ， 要 么 
包含 指向 不 可 变 对 象 的 引用 《〈 见 第 15 条 ) 。 如 果 tina 域 包含 可 变 对 象 
的 引用 ， 她 便 具 有 非 final 域 的 所 有 去 电 。 虽 然 引 用 本 身 不 能 被 修改 ， 
但 是 它 所 引用 的 对 象 却 可 以 被 修改 一 一 这 会 导致 灾难 性 的 后 末 。 


注意 ， 长 度 非 零 的 数组 总 是 可 变 的 ， 所 以 ， 类 具有 公有 的 静态 rinal 数 















































组 域 ， 或 者 返回 这 种 域 的 访问 方法 ， 这 几乎 总 是 错误 的 。 如 果 类 具有 
这 样 的 域 或 者 访问 方法 ， 客 户 端 将 能 够 修改 数组 中 的 内 容 。 这 是 安全 漏 
洞 的 一 个 常见 根源 : 

// Potential security hole! 


public static final Thing[] VALUES = { ... }; 


要 注意 ， 许 多 IDE 会 产生 返回 指向 私有 数组 域 的 引用 的 访问 方法 ， 这 样 
束 会 产生 这 个 问题 。 修 正 这 个 问题 有 两 种 方法 。 可 以 使 公有 数组 变 成 私 
有 的 ， 并 增加 一 个 公有 的 不 可 变 列表 : 


private static final Thing[] PRIVATE_VALUES = { ... }; 





public static final List<Thing> VALUES = 


Collections.unmodifiableList(Arrays.asList(PRIVATE_VALUES) ) ) ; 


另 一 种 方法 是 ， 可 以 使 数组 变 成 私有 的 ， 并 添加 一 个 公有 方法 ， 它 返回 
私有 数组 的 一 个 备份 : 
private static final Thing[] PRIVATE_VALUES = { ... }; 
public static final Thing[] values() { 
return PRIVATE_VALUES.clone(); 


} 


怎么 处 理 这 个 结果 。 
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要 在 这 两 种 方法 之 间 做 出 选择 ， 得 考虑 客户 端 可 和 
哪 种 返回 类 型 会 更 加 方便 ? 哪 种 会 得 到 更 好 的 性 和 
总 而 言 之 ， 你 应 该 始终 尽 可 能 地 降低 可 访问 性 。 你 在 仔细 地 设计 一 个 最 
小 的 公有 API 之 后 ， 应 该 防止 把 任何 散乱 的 类 、 接 口 和 成 员 变 成 API 的 
一 部 分 。 除 了 公有 静态 _rinal 域 的 特殊 情形 之 外 ， 公 有 类 都 不 应 该 包含 
公有 域 。 并 且 要 确保 公有 静态 rinal 域 所 引用 的 对 象 都 是 不 可 变 的 。 


第 14 条 : 在 公有 类 中 使 用 访问 方法 而 
非 公 有 域 


kb 
已 
k 
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有 时 候 ， 可 能 会 编写 一 些 退 化 类 (degenerate classes) ， 没 有 什么 作 
用 ， 只 是 用 来 集中 实例 域 : 


// Degenerate classes like this should not be public! 


class Point { 


public 


public 


double x; 


double y; 


由 于 这 种 类 的 数据 是 可 以 被 直接 访问 的 ， 这 些 类 没有 提供 封闭 
Cecapsulation) 的 功能 〈 见 第 13 条 ) 。 如 果 不 改 变 API， 就 无 法 改变 它 
的 数据 表示 法 ， 也 无 法 强加 任何 约束 条 件 ; 当 域 被 访问 的 时 候 ， 无 法 采 
取 任 何 辅助 的 行动 。 坚 持 面 同 对 象 程序 设计 的 程序 猜 对 这 种 类 深 恶 痛 
绝 ， 认 为 应 该 用 包含 私有 域 和 公有 访问 方法 ( getter ) ARG. X 
于 可 变 的 类 来 说 ， 应 该 用 包含 私有 域 和 公有 设 值 方 法 ( setter ) 的 类 


RE: 





// Encapsulation of data by accessor methods and mutators 


class Point { 


private 


private 


public 
this 


this 


public 


public 


public 


public 


double x; 

double y; 

Point ( double x, 
.X = X; 
D = Ma 
double getX () { 


double getY () { 


void setX ( double 


void setY ( double 


double 


return 


return 


y) 


坚 无 疑问 ， 说 到 公有 类 的 时 候 ， 坚 持 面 向 对 象 程序 设计 思想 的 看 法 
是 正确 的 : 如 果 类 可 以 在 它 所 在 的 包 的 外 部 进行 访问 ,就 提供 访问 
方法 ， 以 保留 将 来 改变 该 类 的 内 部 表示 法 的 灵活 性 。 如 果 公 有 类 
暴露 了 它 的 数据 域 ， 要 想 在 将 来 改变 其 内 部 表示 法 是 不 可 能 的 ， 因 
ABBR FP sa CIS CAA WE To 


然而 ， WR EBRMAN, RA EMAMRKER, BRR CN 
数据 域 并 没有 本 质 的 错误 一 一 假设 这 些 数据 域 确实 描述 了 该 类 所 
提供 的 抽象 。 这 种 方法 比 访问 方法 的 做 法 更 不 会 产生 视 党 混乱 ， 无 
论 实 在 类 定义 中 ， 还 是 在 使 用 类 的 客户 端 代 码 中 。 虽 然 客 户 端 代码 
与 该 类 的 内 部 表示 法 紧密 相连 ， 但 是 这 些 代码 被 完 定 在 包含 该 类 的 
包 中 。 如 有 必要 ， 不 改变 包 之 外 的 任何 代码 而 只 改变 内 部 数据 表示 
法 也 是 可 以 的 。 在 私有 风 套 类 的 情况 下 ， 改 变 的 作用 范围 被 进一步 
限制 在 外 围 类 中 。 


Java 平 台 类 库 中 有 几 个 类 违反 了 “公有 类 不 应 该 直接 暴露 数据 域 ” 的 
告诫 。 显著 的 例子 包括 java.awt 包 中 的 Point 和 Dimension 类 。 它们 
是 不 值得 效仿 的 例子 ， 相 反 ， 这 些 类 应 该 被 当做 反面 的 警告 示例 。 
正如 第 55 条 中 所 讲述 的 ， 诀 定 暴露 Dimension 类 的 内 部 数据 造成 了 
严重 的 性 能 问题 ， 而 且 ， 这 个 问题 至 今 依 然 存在 。 


让 公有 类 直接 骏 露 域 虽 然 从 来 都 不 是 种 好 办 法 ， 但 是 如 果 域 是 不 可 
变 的 ， 这 种 做 法 的 危害 就 比较 小 一 些 。 如 果 不 改变 类 的 API， 就 无 
法 改变 这 种 类 的 表示 法 ， 当 域 被 读 取 的 时 候 ， 你 也 无 法 采取 辅助 的 
行动 ， 但 是 可 以 强加 约束 条 件 。 例 如 ， 这 个 类 确保 了 每 个 实例 都 表 
示 一 个 有 效 的 时 间 : 


// Public class with exposed immutable fields - questionable 



































public final class Time { 
private static final int HOURS _PER_DAT = 24; 


private static final int MINUTES _PER_HOUR = 60 ; 


public final int hour; 


public final int minute; 


public Time ( int hour, int minute) { 


if (hour < © || hour >= HOURS_PER_DAT) 


throw new IllegalArgumentException( "Hour: " + hour); 
if (minute < 0 || minute >= MINUTES_PER_HOUR) 
throw new IllegalArgumentException( "Min: " + minute); 


this .hour = hour; 


this .minute = minute; 


. // Remainder omitted 


} 








总 之 ， 公 有 类 永远 都 不 应 该 暴露 可 变 的 域 。 虽 然 还 是 有 问题 ， 
但 是 让 公有 类 骏 露 不 可 变 的 域 其 实 危 害 比较 小 。 但 是 ， 有 时 候 
会 需要 用 包 级 私有 的 或 者 私有 的 藤 套 类 来 暴露 域 ， 无 论 这 个 类 
是 可 变 的 还 是 不 可 变 的 。 


第 15 条 : 使 可 变性 最 小 化 


不 可 变 类 只 是 其 实例 不 能 被 修改 的 类 。 每 个 实例 中 包含 的 所 有 
言 轧 都 必须 在 创建 该 实例 的 时 候 就 提供 ， 并 在 对 象 的 整个 生命 
周期 Cifetime) 内 固定 不 变 。Java 平 台 类 库 中 包含 许多 不 可 变 
的 类 ， 其 中 有 String 、 基本 类 型 的 包装 类 、 BigInteger 和 

BigDecimal 。 存在 不 可 变 的 类 有 许多 理由 : 不 可 变 的 类 比 可 变 
T 

















为 了 使 类 成 为 不 可 变 ， 要 遵循 下 面 五 条 规则 : 


1. 不 要 提供 任何 会 修改 对 象 状 态 的 方法 (也 成 为 
mutator) 。[ 注 1] 

2. 保证 类 不 会 被 扩展 。 这 样 可 以 防止 粗心 或 者 恶意 的 子 类 
假装 对 象 的 状态 已 经 改变 ， 从 而 破坏 该 类 的 不 可 变 行为 。 
为 了 防止 子 类 化 ， 一 般 做 法 是 使 这 个 类 成 为 final 的 ， 但 
是 后 面 我 们 还 会 讨论 到 其 他 的 做 法 。 

3. 使 所 有 的 域 都 是 finr 的 。 通 过 系统 的 强制 方式 ， 这 可 
以 清楚 地 表明 你 的 意图 。 而 且 ， 如 果 一 个 指 辣 新 创建 实例 





的 引用 在 缺乏 同步 机 制 的 情况 下 ， 从 一 个 线程 被 传递 到 另 
一 个 线程 ， 就 必需 确保 正确 的 行为 ， 正 如 内 存 模 型 
(memory model) 中 所 述 [JLS，17.5; Goetzo6 16]. 

4. 使 所 有 的 域 都 成 为 私有 的 。 这 样 可 以 防止 客户 端 获 得 访 
问 被 域 引用 的 可 变 对 象 的 权限 ， 并 防止 客户 端 直接 修改 这 
些 对 象 。 虽 然 从 技术 上 讲 ， 人 允许 不 可 变 的 类 具有 公有 的 
final 域 ， 只 要 这 些 域 包含 基本 类 型 的 值 或 者 指 癌 不 可 变 
对 象 的 引用 ， 但 是 不 建议 这 样 做 ， 因 为 这 样 会 使 得 在 以 后 
的 版 本 中 无 法 再 改变 内 部 的 表示 法 〈 见 第 13 条 ) 。 

5. 确保 对 于 任何 可 变 组 件 的 互 斥 访问 。 如 果 类 具有 指 同 可 
变 对 象 的 域 ， 则 必须 确保 该 类 的 客户 端 无 法 获得 指 癌 这 些 
对 象 的 引用 。 并 且 ， 了 永远 不 要 用 客户 端 提 供 的 对 象 引用 来 
初始 化 这 样 的 域 ， 也 不 要 从 任何 访问 方法 〈accessor) 中 
返回 该 对 象 引 用 。 在 构造 器 、 访问 方法 和 readobject Tie 
〈 见 第 76 条 ) 中 请 使 用 保护 性 拷贝 (defensive copy) 技术 
( 见 第 39 条 ) 。 


前 面条 目 中 的 许多 例子 都 是 不 可 变 的 ， 其 中 一 个 例子 是 第 9 条 
中 的 phonenumber ， 它 针对 每 个 属性 都 有 访问 方法 

(accessor) ， 但 是 没有 对 应 的 设 值 方法 (mutator) 。 下 面 是 
个 稍微 复杂 一 点 的 例子 : 


public final class Complex { 




















private final double re; 


private final double im; 


public Complex ( double re, double im) { 
this .re = re; 


this .im = im; 


// Accessors with no corresponding mutators 
public double realPart () { return re; } 


public double imaginaryPart () { return im; } 


public Complex add (Complex c) { 


return new Complex(re + c.re, im + c.im); 


public Complex subtract (Complex c) { 


return new Complex(re - c.re, im - c.im); 


public Complex multiply (Complex c) { 
return new Complex(re * c.re - im * c.im, 


ines? Gola ap all eum, 


public Complex divide (Complex c) { 
double tmp = c.re cre + c.im * c.im; 
return new Complex((re * c.re + im * c.im) / tmp, 


(im * c.re - re * c.im) / tmp); 


@Override public boolean equals (Object o) { 
if RO= Withis } 
return true ; 
if (!(o instanceof Complex)) 
return false ; 


Complex c = (Complex) o; 


// See page 43 to find out why we use compare instead of == 
return Double.compare(re, c.re) == 0 && 


Double.compare(im, c.im) == 0 ; 


@Override public int hashCode () { 
int result = 17 + hashDouble(re); 
result = 31 * result + hashDouble(im); 


return result; 


private int hashDouble ( double val) { 
long longBits = Double.doubleToLongBits(re); 


return ( int ) (longBits ^ (longBits >>> 32 )); 


@Override public String toString () { 


return et Gi + re + W + " + im + be 0 





这 个 类 表示 一 个 复数 〈 complex number ， 具 有 实 部 和 虚 
部 ) 。 除 了 标准 的 objet 方法 之 外 ， 它 还 提供 了 针对 实 
部 和 虚 部 的 访问 方法 ， 以 及 4 种 基本 的 算数 运算 : 加法、 
减法 、 乘 法 和 除法 。 注 意 这 些 算数 运算 是 如 何 创建 并 返回 
新 的 complex 实例 ， 而 不 是 修改 这 个 实例 。 大 多 数 重要 的 
不 可 变 类 都 使 用 了 这 种 模式 。 它 被 称 为 函数 的 
(functional) 做 法 ， 因 为 这 些 方法 返回 了 一 个 函数 的 结 
果 ， 这 些 函 数 对 操作 数 进行 运算 但 并 不 修改 它 。 与 之 相对 
应 的 更 常见 的 是 过 程 的 〈procedural) 或 者 命令 式 的 
(imperative) 做 法 ， 使 用 这 些 方式 时 ， 将 一 个 过 程 作 用 
在 它们 的 操作 数 上 ， 对 导致 它 的 状态 发 生 改 变 。 


如 果 你 对 函数 方式 的 做 法 还 不 太 熟 悉 ， 可 能 会 觉得 它 显 得 
不 太 目 然 ， 但 是 它 带 来 了 不 可 变性 ， 有 具有 许多 优点 。 不 可 
变 对 象 比较 简单 。 不 可 变 对 象 可 以 只 有 一 种 状态 ， 即 被 

创建 是 的 状态 。 如 果 你 能 够 确保 所 有 的 构造 侣 都 建 六 了 这 
个 类 的 约束 关系 ， 殊 可 以 确保 这 些 约束 关系 在 整个 生命 周 





























期 内 永远 不 再 发 生变 化 你 和 使 用 这 个 类 的 程序 员 都 无 需 再 
做 额外 的 工作 来 维护 这 些 约束 关系 。 男 一 方面 ， 可 变 的 对 
象 可 以 有 任意 复杂 的 状态 空间 。 如 有 果 文 档 中 没有 对 mnutator 
方法 所 执行 的 状态 转换 提供 精确 的 描述 ， 要 可 徘 地 使 用 一 
个 可 变 类 是 非常 困难 的 ， 甚 至 是 不 可 能 的 。 


不 可 变 对 象 本 质 上 是 线程 安全 的 ， 它 们 不 要 求 同 步 。 当 

多 个 线程 并 发 访问 这 样 的 对 象 时 ， 它 们 不 会 遭 到 破坏 。 这 
无 疑 是 获得 线程 安全 最 容易 的 办 法 。 实 际 上 ， 没 有 任何 线 
程 会 注意 到 其 他 线程 对 于 不 可 变 对 象 的 影响 。 所 以 ， 不 可 
变 对 象 可 以 被 自由 地 共享 。 不 可 变 类 应 该 充分 利用 这 种 

优势 ， 吾 励 客户 端 尽 可 能 地 重用 现 有 的 实例 。 要 做 到 这 一 
点 ， 一 个 很 简单 的 办 法 就 是 ， 对 于 频 楷 用 到 的 值 ， 为 它们 
提供 公有 的 静态 final “Hi Ht. PIM, complex 类 有 可 能 会 


提供 下 面 的 常量 : 


public static final Complex ZERO = new Complex( 9, 0 ); 





























public static final Complex ONE = new Complex( 1, 0 ); 


public static final Complex I = new Complex( 0, 1); 


这 种 方法 可 以 被 进一步 扩展 。 不 可 变 的 类 可 以 提供 一 些 静 
态 工 厂 〈 见 第 1 条 〉 ， 它 们 把 频繁 被 请 求 的 实例 缓存 起 
来 ， 从 而 当 现 有 实例 可 以 符合 请 求 的 时 候 ， 就 不 必 创 建新 
的 实例 。 所 有 基本 类 型 的 包装 类 和 Bigrmteger 都 有 这 样 的 
静态 工厂 。 使 用 这 样 的 静态 工厂 也 使 得 客户 端 之 间 可 以 共 
译 现 有 的 实例 ， 而 不 用 创建 新 的 实例 ， 从 而 降低 内 存 占 用 
和 垃圾 回收 的 成 本 。 在 设计 新 的 类 时 ， 选 择 用 静态 工 三代 
人 蔡 公 有 的 构造 器 可 以 让 你 以 后 有 添加 缓存 的 灵活 性 ， 而 不 
Wo 2 Me 2 i o 


“不 可 变 对 象 可 以 被 自由 地 共享 ”导致 的 结果 是 ， 永 远 也 不 
需要 进行 保护 性 拷贝 〈 见 第 39 条 ) 。 实 际 上 ， 你 根本 无 
需 做 任何 拷贝 ， 因 为 这 些 找 贝 始终 等 于 原始 的 对 象 。 因 

此 ， 你 不 需要 ， 也 不 应 该 为 不 可 变 的 类 提供 cione 方法 或 
者 拷贝 构造 器 (copy constructor ， 见 第 11 条 ) 。 这 一 点 
在 Java 平 台 的 早起 并 不 好 理解 ， 所 以 string 类 仍然 具有 找 
由 构造 器 ， 但 是 应 该 尽量 少 用 它 〈( 见 第 5 条 )。 











不 仅 可 以 共享 不 可 变 对 象 ， 甚 至 也 可 以 共享 它们 的 内 部 信 
E o PIU, BigInteger 类 内 部 使 用 了 符号 数值 表示 法 。 符 
号 用 一 个 int 类 型 的 值 来 表示 ， 数 值 则 用 一 个 int 数组 
表示 。 negate 方法 产生 一 个 新 的 BigInteger ， 其 中 数值 是 
一 样 的 ， 符 号 则 是 相反 的 。 它 并 不 需要 拷贝 数组 ， 新建 的 
的 piginteger 也 指向 原始 实例 中 的 同一 个 内 部 数组 。 


不 可 变 对 象 为 其 他 对 象 提供 了 大 量 的 构建 (building 
blocks) ， 无 论 是 可 变 的 还 是 不 可 变 的 对 象 。 如 果 知 道 一 
个 复杂 对 象 内 部 的 组 件 对 象 不 会 改变 ， 要 维护 它 的 不 变性 
约束 是 比较 容易 的 。 这 条 原则 的 一 种 特例 在 于 ， 不 可 变 对 
象 构 成 了 大 量 的 映射 键 (map key) 和 集合 元 素 (set 
element) ; 一 旦 不 可 变 对 象 进入 到 映射 (map) 或 者 集合 
(set) 中 ， 尽 管 这 破坏 了 映射 或 者 集合 的 不 变性 约束 ， 但 
是 也 不 用 担心 它们 的 值 会 发 生变 化 。 

不 可 变 类 真正 唯一 的 缺点 是 ， 对 于 每 个 不 同 的 值 都 需要 一 
个 单独 的 对 象 。 创 建 这 种 对 象 的 代价 可 能 很 高 ， 特 别 是 
对 于 大 型 对 象 的 情形 。 例 如 ， 假 设 你 有 一 个 上 百 万 位 的 
BigInteger ， 想 要 改变 它 的 低位 : 


BigInteger moby = ...; 




















moby = moby.flipBit( © ); 


flipBit 方法 创建 了 一 个 新 的 BigInteger 实例 ， 也 有 上 百 
万 位 长 ， 它 与 原来 的 对 象 只 天 一 位 不 同 。 这 项 操作 所 消耗 
的 时 间 和 空间 与 Bigrznteger 的 成 正比 。 我 们 拿 它 与 
java.util.BitSet 进行 比较 。 与 BigInteger 类 似 ， BitSet AR 
表 一 个 任意 长 度 的 位 序列 ， 但 是 与 pigtnteger 不 同 的 是 ， 
Bitset 是 可 变 的 。 Bitset 类 提供 了 一 个 方法 ， 人 允许 在 固 
(constant time) 内 改变 此 “ 百 万 位 ?实例 中 单个 位 
条 状态 。 


如 打 你 执行 一 个 多 步骤 的 操作 ， 并 且 每 个 步骤 都 会 产生 一 
个 新 的 对 象 ， 除 了 最 后 的 结果 之 外 其 他 的 对 象 最 终 都 会 被 
丢弃 ， 此 时 性 能 问题 就 会 显露 出 来 。 处 理 这 种 问题 有 两 种 
办 法 。 第 一 种 办 法 ， 先 猜测 一 下 会 经 向 用 到 哪些 多 步 又 的 














操作 ， 然 后 将 它们 作为 基本 类 型 提供 。 如 果 某 个 多 步骤 操 
作 已 经 作为 基本 类 型 提供 ， 不 可 变 的 类 就 可 以 不 必 在 每 个 
步骤 单独 创建 一 个 对 象 。 不 可 变 的 类 在 内 部 可 以 更 加 灵 
活 。 例 如 ， Bigrnteger 有 一 个 包 级 私有 的 可 变 “ 配 套 类 
(companing class) ”, 它 的 用 途 是 加 速 诸 如 “ 模 指 数 
(modular exponentiation) ”这 样 的 多 步骤 操作 。 由 于 前 面 
提 到 的 诸多 原因 ， 使 用 可 变 的 配套 类 比 使 用 Bigrnteger 要 
困难 得 多 ， 但 幸运 的 是 ， 你 并 不 需要 这 样 做 。 因 为 
BigInteger 的 实现 者 已 经 莹 你 完成 了 所 有 困难 的 工作 。 


如 果 能 够 精确 地 预测 出 客户 端 将 要 在 不 可 变 的 类 上 执行 哪 
些 复杂 的 多 阶段 操作 ， 这 种 包 级 私有 的 可 变 配套 类 就 可 以 
工作 得 很 好 。 如 果 无 法 预测 ， 最 好 的 办 法 是 提供 一 个 公有 
的 可 变 配套 类 。 在 Java 平 台 类 库 中 ， 这 种 方法 的 主要 例子 
是 String ae 它 的 可 变 配 套 类 是 StringBuilder (和 基本 上 
己 经 废弃 的 stringuffer ) 。 可 以 这 样 认 为 ， 在 特定 的 环 

境 下 ， 相对 于 BigInteger Ma > BitSet 同样 扮演 了 可 变 配 
套 类 的 角色 。 


现在 你 已 经 知道 了 如 何 构建 不 可 变 的 类 ， 并 且 了 解 了 不 可 
变性 的 优点 和 缺点 ， 现 在 我 们 来 讨论 其 他 的 一 些 设计 方 
案 。 前 面 提 到 过 ， 为 了 确保 不 可 变性 ， 类 绝对 不 允许 自尽 
被 子 类 化 ， 除 了 “使 类 成 为 final 的 ”这 种 方法 之 外 ， 还 有 
一 种 更 加 灵活 的 办 法 也 可 以 做 到 这 一 点 。 让 不 可 变 的 类 变 
成 final 的 另 一 种 办 法 就 是 ， 让 类 的 所 有 构造 器 都 变 成 私 
有 的 或 者 包 级 私有 的 ， 并 添加 公有 的 静态 工厂 (static 
factory) 来 代 蔡 公有 的 构造 右 〈 见 第 1 条 ) 。 


为 了 具体 说 明 这 种 方法 ， 下 面 以 complex 为 例 ， 看 看 如 何 
使 用 这 种 方法 : 


// Immutable class with static factories instead of constructors 




















public class Complex { 
private final double re; 


private final double im; 


private Complex ( double re, double im) { 


this .re = re; 


this .im = im; 


public static Complex valueOf ( double re, double 
im) 


return new Complex(re, im); 


. // Remainder unchanged 


} 








虽然 这 种 方法 并 不 和 常用， 但 它 经 党 是 最 好 的 普 代 方法 。 它 
最 灵活 ， 因 为 它 允 许 使 用 多 个 包 级 私有 的 实习 类 。 对 于 处 
在 它 的 包 外 部 的 客户 端 而 言 ， 不 可 变 类 实际 上 是 tinal 
的 ， 因 为 不 可 能 把 来 目 另 一 个 包 的 类 、 缺 少 公 有 的 活 受 保 
护 的 构造 器 的 类 进行 扩展 。 除 了 允许 多 个 实现 类 的 灵活 性 
之 外 ， 这 种 方法 还 使 得 有 可 能 通过 改善 静态 工厂 的 对 象 绥 
存 能 力 ， 在 后 续 的 发 行 版 本 中 改进 该 类 的 性 能 。 


静态 工厂 与 构造 器 想必 具有 许多 其 他 的 优势 ， 正 如 在 第 1 
条 中 所 讨论 的 。 例 如 ， 假 设 你 希望 提供 一 种 “基于 极 坐标 
创建 复数 ”的 方式 。 如 果 使 用 构造 器 来 实现 这 样 的 功能 ， 

可 能 会 使 得 这 个 类 很 零乱 ， 因 为 这 样 的 构造 器 与 已 用 的 构 
造 器 Complex(double, double) 具有 相同 的 签名 。 通过 静态 工 
三 ， 这 很 容易 做 到 。 只 需 添 加 第 二 个 静态 工厂 ， 并 且 工厂 
的 名 字 清 楚 地 表明 了 它 的 功能 即 可 : 


public static Complex valueOfPolar ( double r, double 
theta) { 














return new Complex(r * Math.cos(theta), 
r * Math.sin(theta) ); 


} 


“4 BigInteger 和 Bigdecimal 刚 被 编写 出 来 的 时 候 ， 对 于 “不 


可 变 的 类 必须 为 final 的 ”还 没有 得 到 广泛 地 理解 ， 所 以 
它们 的 所 有 方法 都 可 能 会 被 履 新 。 遗 憾 的 是 ， 为 了 保持 问 
后 兼容 ， 这 个 问题 一 直 无 法 得 以 修正 。 如 果 你 在 编写 一 个 
类 ， 它 的 安全 性 依赖 于 (来 自 不 可 信和 客户 端的 ) 
BigInteger 或 者 Bigvecimal 参数 的 不 可 变性 ， 束 必须 进行 
检查 ， 以 确定 这 个 参数 是 否 为 “真正 的 ”BigInteger 或 者 
BigDecimal > 而 不 是 不 可 信任 子 类 的 实例 。 如 果 是 后 者 的 
话 ， 就 必须 在 假设 它 可 能 是 可 变 的 前 提 下 对 它 进 行 保 护 性 
拷贝 〈 见 第 39 条 ) : 


public static BigInteger safeInstance (BigInteger val) { 

















if (val.getClass() != BigInteger.calss) 
return new BigInteger(val.toByteArray()); 
return val; 


} 


本 条 目 开 头 初 关于 不 可 变 类 的 诸多 规则 指出 ， 没 有 方法 会 
修改 对 象 ， 并 且 它 的 所 有 域 都 必须 是 tinai 的 。 实 际 上 ， 
这 些 规则 比 真正 的 要 求 更 强硬 了 一 点 ， 为 了 提供 性 能 可 以 
有 所 放松 。 事 实 上 应 该 是 这 样 : 没有 一 个 方法 能 够 对 对 象 
的 状态 产生 外 部 可 见 Cexternally visible) 的 改变 。 然 而 ， 
许多 不 可 变 的 类 拥有 一 个 或 者 多 个 非 final 的 域 ， 它 们 在 
第 一 次 被 请 求 执行 这 些 计算 的 时 候 ， 把 一 些 开 销 昂贵 的 计 
算 结 果 绥 存在 这 些 域 中 。 如 有 果 将 来 再 次 请 求 同 样 的 计算 ， 
就 直接 返回 这 些 缓存 的 值 ， 从 而 节约 了 重新 计算 所 需要 的 
开销 。 这 种 技巧 可 以 很 好 地 工作 ， 因 为 对 象 是 不 可 变 的 ， 
它 的 不 可 变性 保证 了 这 些 计 算 如 果 被 再 次 执行 ， 就 会 产生 
同样 的 结果 。 


例如 ， PhoneNumber 类 的 hashCode 方法 ( 见 第 9 条 ) 在 第 一 
次 被 调用 的 时 候 ， 计 算出 散 列 码 ， 然 后 把 它 绥 存 起 来 ， 以 
备 将 来 被 再 次 调用 时 使 用 。 这 种 方法 是 延迟 初始 化 《lazy 
initialization) 〈 见 第 71 条 ) 的 一 个 例子 ， string 类 也 用 
到 了 。 


有 关 序 列 化 功能 的 一 条 告 诚 有 必要 在 这 里 提出 来 。 如 果 你 
选择 让 自己 的 不 可 变 类 实现 serializable 接口 ， 并 且 它 包 























ed be ee a AO) Ta 
的 readobject 或 者 readResolve 方法 ， 或 者 使 用 
ObjectOutputStream.writeUnshared 和 ObjectInputStream,readUnshared 
方法 ， 即 使 默认 的 序列 化 形式 是 可 以 接受 的 ， 也 是 如 此 。 
售 则 攻击 者 可 能 从 不 可 变 的 类 创建 可 变 的 实例 。 这 个 话题 
的 详细 内 容 请 参见 第 76 条 。 


忆 之 ， 坚 决 不 要 为 每 个 get 方 法 编写 一 个 相应 的 set 方 法 。 

除非 有 很 好 的 利用 要 让 类 成 为 可 变 的 类 ， 人 否则 就 应 该 是 不 
可 变 的 。 不 可 变 的 类 有 许多 有 点 ， 唯 一 确定 是 在 特定 的 

情况 下 存在 潜在 的 性 能 问题 。 你 应 该 总 是 使 一 些小 的 值 对 
象 ， 比如 PhoneNumber 和 Complex 3; 成 为 不 可 变 的 (在 Java 
平台 类 库 中 ， 有 几 个 类 如 java.util.Date 和 java.awt.Point 

， 它 们 本 应 该 是 不 可 变 的 ， 但 实际 上 却 不 是 ) o MEMZ 
认真 考虑 把 一 些 较 大 的 值 对 象 做 成 不 可 变 的 ， 例 如 string 
和 BigInteger 。 只 有 当 你 确认 有 必要 实现 令 人 满意 的 性 能 
时 《 见 第 55 条 ) ， 才 应 该 为 不 可 变 的 大 提供 公有 的 可 变 配 


FJ o 














对 于 有 些 类 而 言 ， 其 不 可 变性 是 不 切实 际 额 的 。 如 果 类 不 
能 被 做 成 是 不 可 变 的 ， 仍 然 应 该 尽 可 能 地 限制 它 的 可 变性 
。 降 低 对 象 可 以 存在 的 状态 数 ， 可 以 更 容易 地 分 析 该 对 象 
的 行为 ， 同 时 降低 出 错 的 可 能 性 。 因 此 ， 除非 有 令 人 信服 
人 
Final Yoo 


构造 器 应 该 创建 完全 初始 化 的 对 象 ， 并 建立 起 所 有 的 约束 
关系 。 不 要 再 构造 占 或 者 静态 工厂 之 外 再 提供 共有 的 初始 
化 方法 ， 除 非 有 令 人 信服 的 理由 必须 这 么 做 。 同 样 地 ， 也 
不 应 该 提供 “重新 初始 化 "方法 〈 它 使 得 对 象 可 以 被 重用 ， 
就 好 像 这 个 对 象 是 由 男 一 不 同 的 初始 状态 构造 出 来 的 一 
样 ) 。 与 所 增加 的 复杂 性 想必 , “重新 初始 化 "方法 通常 并 
没有 带 来 太 多 的 性 能 优势 。 


可 以 通过 TimerTask 类 来 说 明 这 些 原 则 。 它 是 可 变 的 ， 但 
是 它 的 状态 空间 补 有 意 地 设计 得 非常 小 。 你 可 以 创建 一 个 
实例 ， 对 它 进 行 调 度 使 它 执行 起 来 ， 也 可 以 随意 地 取消 

它 。 一 旦 一 个 定时 器 任务 (timer task) 已 经 完成 ， 或 者 已 
































经 取消 ， 就 不 可 能 再 对 它 重 新 调度 。 


最 后 值得 注意 的 一 点 与 本 条 目 中 的 comiex 类 有 关 。 这 个 
例子 只 是 被 用 来 演示 不 可 变性 的 ， 它 不 是 一 个 工业 强度 
( 即 产 品级 ) 的 复数 实现 。 它 对 复数 乘法 和 除法 使 用 标准 
的 计算 公式 ， 会 进行 不 正确 的 舍 入 ， 并 对 复数 nan 和 无 穷 
大 没有 提供 很 好 的 语义 [Kaha91，Smith63，Thomas94]。 




















TE: 
1. 即 改变 对 象 属性 的 方法 。 一 一 编辑 注 


第 16 条 : 复合 优 于 继承 


继承 〈inheritance) 是 实现 代码 重用 的 有 力 手 段 ， 但 它 并 
非 永远 是 完成 这 项 工作 的 最 佳 工具 。 使 用 不 当 会 导致 软件 
变 得 很 脆弱 。 在 包 的 内 部 使 用 继承 是 非常 安全 的 ， 在 那 

里 ， 子 类 和 超 类 的 实现 都 处 在 同一 个 程序 员 的 控制 之 下 。 
对 于 专门 为 了 继承 而 设计 、 并 且 有 具有 很 好 的 文档 的 类 来 说 
〈 见 第 17 条 ) ， 使 用 继承 也 是 非常 安全 的 。 然 而 ， 对 普通 
的 具体 类 (concrete class) 进行 跨越 包 边 界 的 集成 ， 则 是 
非常 危险 的 。 提 示 一 下 ， 本 书 使 用 “继承 ”一 词 ， 含 义 是 实 
现 继承 (implementation inheritance ， 当 一 个 类 扩展 另 一 

个 类 的 时 候 ) 。 本 条 目 中 讨论 的 问题 并 不 适用 于 接口 继承 
(interface inheritance ， 当 一 个 类 实现 一 个 接口 的 时 候 ， 

或 者 当 一 个 接口 扩展 另 一 个 接口 的 时 候 ) 。 


与 方法 调用 不 同 的 是 ， 继 承 打 破 了 封闭 性 JSnyder861 。 换 
句 话 说， 子 类 依赖 于 其 超 类 中 特定 功能 的 实现 细节 。 超 类 
的 实现 可 能 会 随 着 太行 版 本 的 不 同 而 有 所 变化 ， 如 果真 的 
发 生 了 变化 ， 子 类 可 能 会 遭 到 破坏 ， 即 使 它 的 代码 完全 没 
有 改变 。 因 而 ， 子 类 必须 要 跟着 其 超 类 的 更 新 而 演变 ， 除 
并 且 具 有 很 好 的 文档 说 
BH 。 

















为 了 说 明 得 更 加 具体 一 点 ， 我 们 假设 有 一 个 程序 使 用 了 


Hashset 。 为 了 调 优 改 程序 的 性 能 ， 需 要 查询 Hasnset » Æ 
一 看 目 从 它 被 创建 以 来 曾经 添加 了 多 少 个 元 素 〈 不 要 与 它 
当前 的 元 际 混 消 起 来 ， 元 素数 目 会 随 痢 元 素 的 删除 而 递 
减 ) 。 为 了 提供 这 种 功能 ， 我 们 得 编写 一 个 hasnset A 
量 ， 它 记录 下 视图 插入 的 元 系数 量 ， 并 针对 该 计数 值 导出 
一 个 访问 方法 。 hashset 类 包含 两 个 可 以 增加 元 素 的 方 
VE: add 和 ada ， 因 此 这 两 个 方法 都 要 被 覆盖 : 
// Broken - Inappropriate use of inheritance! 


public class InstrumentedHashSet < E > extends HashSet < 
E> { 


// The number of attempted element insertions 


private int addCount = 0 ; 


public InstrumentedHashSet () { 


} 


public InstrumentedHashSet ( int initCap, float 
loadFactor ) 


super (initCap, loadFactor); 


@Override public boolean add (E e) { 
addCount++; 


return super .add(e); 


@Override public boolean addAll 
(Collection<? extends E> c) { 


addCount += c.size(); 


return super .addAll(c); 


public int getAddCount () { 


return addCount; 





这 个 类 看 起 来 非常 合理 ， 但 是 它 不 能 正常 工作 。 假 设 
我 们 创建 了 一 个 实例 ， 并 利用 aon kiN T= 
DILA: 


InstrumentedHashSet<String> s = 
new InstrumentedHashSet<String>(); 


s.addAll(Arrays.asList( "Snap" , "Crackle" , "Pop" )); 


这 时 候 ， 我 们 期 望 getaddcount 方法 将 会 返回 3， 但 是 
它 实 际 上 返回 的 是 6. 哪 里 出 错 了 呢 ? 在 nashset 的 内 
部 ， addAll 方法 是 基于 它 的 aad 方法 来 实现 的 ， 即 
使 hashset 的 文档 中 并 没有 说 明 这 样 的 实现 细 市 ， 这 
也 是 合理 的 。 InstrumentedHashSet 中 的 addAll 方法 首先 
y addCount 增加 3， 然后 利用 super .addAll 来 调用 
HashSet 的 addAll 实现 。 然后 又 一 次 调用 到 被 
InstrumentedHashSet jet JAY add 方法 ， 每 个 元 素 调 用 
一 次 。 这 三 次 调用 又 分 别 给 aadcount 加 了 1， 所 以 ， 
总 共 增 加 了 6: 通过 aoan 方法 增加 的 每 个 元 素 都 被 
计算 了 两 次 。 


我 们 只 要 去 掉 被 覆盖 的 aaar 方法 ， 就 可 以 “修正 ”这 
NFA. HVACR SBI ASAT UES VE, (Bee, € 
的 功能 正确 性 则 需要 依赖 于 这 样 的 事实 : Hashset 的 

addAll 方法 是 在 它 的 aa 方法 上 实现 的 。 这 种 “自用 
PE (self-use) ”是 实现 细节 ， 不 是 承 话 ， 不 能 保证 在 

Java 平 台 的 所 有 实现 中 都 保持 不 变 ， 不 能 保证 随 着 发 

行 版 本 的 不 同 而 不 发 生变 化 。 因 此 ， 这 样 得 到 的 


InstrumentedHashSet 类 将 是 非常 脆弱 的 o 


稍微 好 一 点 的 做 法 是 ， 履 盖 aan 方法 来 过 历 指定 
的 集合 ， 为 每 个 元 素 调 用 一 次 aad 方法 。 这 样 做 可 以 
保证 得 到 正确 的 结果 ， 不 管 Hashset 的 adaa 方法 是 








GE add 方法 的 基础 上 实现 ， 因 为 HashSet 的 addAll 
实现 将 不 会 再 被 调用 到 。 然 而 ， 这 项 技术 并 没有 解决 
所 有 的 问题 ， 它 相当 于 重新 实现 了 超 类 的 方法 ， 这 些 
超 类 的 方法 可 能 是 自用 的 《〈self-use) ， 也 可 能 不 是 自 
用 的 ， 这 种 方法 很 困难 ， 也 非常 耗 时 ， 并 且 容 易 出 

错 。 此 外 ， 这 样 做 并 不 总 是 可 行 的 ， 因 为 无 法 访问 对 
于 子 类 来 说 的 私有 域 ， 所 以 有 些 方法 就 无 法 实现 。 


导致 子 类 脐 弱 的 一 个 相关 的 原因 是 ， 它 们 的 超 类 在 后 
续 的 发 行 版 本 中 可 以 获得 新 的 方法 。 假 设 一 个 程序 的 
安全 性 依赖 于 这 样 的 事实 : 所 有 被 插入 到 某 个 集合 中 
的 元 素 都 满足 某 个 先决 条 件 。 下 面 的 做 法 束 可 以 确保 
这 一 点 : 对 集合 进行 子 类 化 ， 并 禾 产 所 有 人 能够 添加 元 
素 的 方法 ， 以 便 确 保 在 加 入 每 个 元 素 之 前 它 是 满足 这 
个 先决 条 件 的 。 如 果 在 后 续 的 发 行 版 本 中 ， 超 类 中 没 
有 增加 能 插入 元 素 的 新 方法 ， 这 种 做 法 束 可 以 正常 工 
作 。 然 而 ， 一旦 超 类 增加 了 这 样 的 新 方法 ， 则 很 有 可 
能 仅仅 由 于 调用 了 这 个 未 被 子 类 和 窗 新 的 新 方法 ， 而 
将 “非法 的 ”元 素 添 加 到 子 类 的 实例 中 。 这 不 是 个 纯粹 
的 理论 问题 。 在 把 Hashtable 和 Vector 加 入 到 
Collections Framework 中 的 时 候 ， 就 修正 了 几 个 这 类 
性 质 的 安全 漏洞 。 


上 面 这 两 个 问题 都 来 源 于 和 窗 盖 (overriding) 动作 。 如 
果 在 扩展 一 个 类 的 时 候 ， 仅 仅 是 增加 新 的 方法 ， 而 不 
履 盖 现 有 的 方法 ， 你 可 能 会 认为 这 是 安全 的 。 虽 然 这 
种 扩展 方式 比较 安全 一 些 ， 但 是 也 并 非 完 全 没有 风 
险 。 如 果 超 类 在 后 续 的 发 行 版 本 中 获得 了 一 个 新 的 方 
法 ， 并 且 不 幸 的 是 ， 你 给 子 类 提供 了 一 个 签名 相同 但 
返回 类 型 不 同 的 方法 ， 那 么 这 样 的 子 类 将 无 法 通过 编 
译 [JLS，8.4.6.3]。 如 果 给 子 类 提供 的 方法 带 有 与 新 的 
超 类 方法 完全 相同 的 签名 和 返回 类 型 ， 实 际 上 就 履 羡 
了 超 类 中 的 方法 ， 因 此 又 回 到 上 述 的 两 个 问题 上 去 
了 。 上 此外， 你 的 方法 是 否 能 够 遵守 新 的 超 类 方法 的 约 
定 ， 这 也 是 很 值得 怀疑 的 ， 因 为 当 你 在 编写 子 类 方法 
的 时 候 ， 这 个 约定 根本 没有 面世 。 

















幸运 的 是 ， 有 一 种 办 法 可 以 避免 前 面 提 到 的 所 有 问 
题 。 不 用 扩展 现 有 的 类 ， 而 是 在 新 的 类 中 增加 一 个 私 
有 域 ， 它 引用 现 有 类 的 一 个 实例 。 这 种 设计 被 称 作 “ 
复合 〈composition) ”， 因 为 现 有 的 类 变 成 了 新 类 的 
一 个 组 件 。 新 类 中 的 每 个 实例 方法 都 可 以 调用 被 包含 
的 现 有 类 实例 中 对 应 的 方法 ， 并 返回 它 的 结果 。 这 被 
BRA 转发 Cforwarding) ， 新 类 中 的 方法 被 称 为 转发 
方法 (forwarding method) 。 这 样 得 到 的 类 将 会 非常 
稳固 ， 它 不 依赖 于 现 有 类 的 实现 细节 。 即 使 现 有 类 添 
加 了 新 的 方法 ， 也 不 会 影响 新 的 类 。 为 了 进行 更 具体 
的 说 明 ， 请 看 下 面 的 例子 ， 它 用 复合 /转发 的 方法 来 
代 蔡 InstrumentedHashSet 类 。 注意 这 个 实现 分 为 两 部 
ay: 类 本 号 和 可 重用 的 转发 类 (forwarding class) ， 
包含 了 所 有 的 转发 方法 ， 没 有 其 他 方法 。 


// Wrapper class - uses compsition in place of inheritance 











public class InstrumentedSet < E > extends 
ForwardingSet < E> { 


private int addCount = 0 ; 


public InstrumentedSet (Set<E> s) { 


super (s); 


@Override public boolean add (E e) { 
addCount++; 


return super .add(e); 


@Override public boolean addAll 
(Collection<? extends E> c) { 


addCount += c.size(); 


return super .addAll(c); 


public int getAddCount () { 


return addCount; 


// Reusable forwarding class 


public class ForwardingSet < E > implements Set < E 


> { 
private final Set<E> s; 


public ForwardingSet (Set<E> s) this Ges ss 


public void clear () 
{ s.clear(); } 


public boolean contains (Object o) { return 
s.contains(o); } 


public boolean isEmpty () { return 
s.isEmpty(); } 

public int size () { return 
s.size(); } 

public Iterator<E> iterator () { return 


s.iterator(); } 


public boolean add (E e) { return 
s.add(e); } 
public boolean remove (Object o) { return 


s.remove(o); } 
public boolean containsAll (Collection<?> c) 


{ return 
s.containsAll(c); } 


public boolean addAll (Collection<? extends E> c) 


{ return 
s.addAll(c); } 


public boolean removeAll (Collection<?> c) 


{ return 
s.removeAll(c); } 


public boolean retrainAll (Collection<?> c) 


{ return 


wn 


.retainAll(c); } 


public Object[] toArray() { return 
.toArray(); } 


wn 


public <T> T[] toArray(T[] a) { return 
.toArray(a); } 


a 


@Override public boolean equals (Object o) 


{ return 


wn 


.equals(o); } 


@Override public int hashCode () { return 
.hashCode(); } 


wn 


@Override public String toString () { return 
s.toString(); } 





Set 接口 的 存在 使 得 InstrumentedSet 类 的 设计 成 
为 可 能 ， 因 为 set 接口 保存 了 Hashset 类 的 功能 
特性 。 除 了 获得 健壮 性 之 外 ， 这 种 设计 也 带 来 了 
格外 的 灵活 性 。 InstrumentedSet 类 实现 了 Set 接 
口 ， 并 且 拥 有 单个 构造 器 ， 它 的 参数 也 是 set 类 
型 。 从 本 质 上 讲 ， 这 个 类 把 一 个 set HERI A 
一 个 set ， 同 时 增加 了 计数 的 功能 。 前 面 提 到 的 
基于 继承 的 方法 只 适用 于 单个 具体 的 类 ， 并 且 对 
于 超 类 中 所 文 持 的 每 个 构造 器 都 要 求 有 一 个 单独 
的 构造 器 ， 与 此 不 同 的 是 ， 这 里 的 包装 类 
(wrapper class) 可 以 被 用 来 包装 任何 set SE 
oe 
。 例 如: 


Set<Date> s = new InstrumentedSet<Date>( new 
TreeSet<Date>(cmp) ); 





Set<E> s2 = new InstrumentedSet<E>( new HashSet<E> 
(capacity) ); 


InstrumentedSet 类 甚至 世 可 以 用 来 临时 蔡 换 一 个 
原本 没有 技术 特性 的 set 实例 : 
static void walk (Set<Dog> dogs) { 


InstrumentedSet<Dog> iDogs = new 
InstrumentedSet<Dog>(dogs) ; 


// Within this method use iDogs instead of dogs 


} 


因为 每 一 个 InstrumentedSet 实例 都 把 另 一 个 Set 
实例 包装 起 来 了 ， 所 以 InstrumentedSet 类 被 称 作 
44,4838 (wrapper class) 。 这 也 正 是 Decorator 模 
式 [Gamma95， p.175], 因为 InstrumentedSet 类 对 
一 个 集合 进行 了 修饰 ， 为 它 增加 了 技术 特性 。 有 
时 候 ， 复 合 和 转发 的 结果 也 被 错误 地 成 为 “ 委托 
(delegation) ”。 从 技术 的 角度 而 言 ， 这 不 是 委 
托 ， 除 非 包 装 对 同 把 目 身 传递 给 被 包 奢 的 对 象 

[Gamma95, p.20]. 


包装 类 几乎 没有 什么 缺点 。 需 要 注意 的 一 点 是 ， 
包装 类 不 适合 用 在 回调 框架 (callback 
framework) 中 ;在 回调 框架 中 ， 对 象 把 自 寻 的 
引用 传递 给 其 他 的 对 象 ， 用 于 后 续 的 调用 (“ 回 
Val”) 。 因 为 被 包装 起 来 的 对 象 并 不 知道 它 外 面 
的 包装 对 象 ， 所 以 它 传 递 一 个 指 同 自 映 的 引用 ( 
this ) ， 回 调 时 避 开 了 外 面 的 包装 对 象 。 这 被 
称 为 SELF 问题 [Lieberman86]。 有 些 人 但 系 转 发 
方法 调用 所 带 来 的 性 能 影响 ， 或 者 包装 对 回 导 致 
的 内 存 占 用 。 在 实践 中 ， 这 两 者 都 不 会 造成 很 大 
的 影响 。 编 写 转 发 方法 倒是 有 点 琐碎 ， 但 是 只 需 
要 给 每 个 接口 编写 一 次 构造 器 ， 转 发 类 则 可 以 通 
过 包含 接口 的 包 痊 你 提供 。 


只 有 当 子 类 真正 是 超 类 的 子 类 型 (subtype) 

时 ， 才 适合 用 继承 。 换 句 话 说， 对 于 两 个 类 A 和 
B， 只 有 当 两 者 之 间 确 实 存在 “is-a” 关 系 的 时 候 ， 

类 B 才 应 该 扩展 类 A。 如 果 你 打算 让 类 B 扩 展 类 

A， 就 应 该 问 问 上 自己 : 每 个 B 确 实 也 是 A 吗 ? 如果 
你 不 能 够 确定 这 个 问题 的 答案 是 肯定 的 ， 那 么 B 
就 不 应 该 扩展 A。 如 果 答 案 是 否定 的 ， 通 常情 况 
下 ，B 应 该 包含 A 的 一 个 私有 实例 ， 并 且 芭 圳 一 

个 较 小 的 、 较 简单 的 API， A 本质 上 不 是 B 的 一 部 






































分 ， 只 是 它 的 实现 细节 而 已 。 


在 Java 平 台 类 库 中 ， 有 许多 明显 违反 这 条 原则 的 
地 方 。 例 如 ， 栈 〈stack) 并 不 是 向 量 

(vector) ; 所 以 Stack 不 应 该 扩展 Vector o 同 
样 地 ， 属 性 列表 也 不 是 散 列 表 ， 所 以 properties 
不 应 该 扩展 hashtable 。 在 这 两 种 情况 下 ， 复 合 
模式 才 是 恰当 的 。 


如 果 在 适合 于 使 用 复合 的 地 方 使 用 了 继承 ， 则 会 
不 必要 地 暴露 实现 细节 。 这 样 得 到 的 API 会 把 你 
限制 在 原始 的 实现 上 ， 永 远 限定 了 类 的 性 能 。 更 
为 严重 的 是 ， 由 于 暴露 了 内 部 的 细节 ， 客 户 端 就 
有 可 能 直接 访问 这 些 内 部 细节 。 这 样 至 少 会 导致 
Ta MEMES. PION, WR p FAIA) properties SK 
fil, BBA p.getProperty(key) 就 有 可 能 产生 与 
p.get(key) 不 同 的 结果 : 前 者 考虑 了 默认 的 属性 
表 ， 而 后 者 是 继承 目 Hashtable 的 ， 它 则 没有 考 
虑 默认 属性 列表 。 最 严重 的 是 ， 客 户 有 可 能 直接 
修改 超 类 ， 从 而 破坏 子 类 的 约束 条 件 。 在 
properties 的 情形 中 ,设计 者 的 目标 是 ， 只 人 允许 
字符 串 作 为 键 (key) AME (value〉， 但 是 直接 
访问 底层 的 hashtable 就 可 以 违反 这 种 约束 条 
件 。 一旦 违反 了 约束 条 件 ， 束 不 可 能 再 使 用 
Properties API 的 其 他 部 分 ( load 和 Store ) 
了 。 等 到 发 现 这 个 问题 时 ， 要 改正 它 已 经 为 时 太 
ee anne aera 























在 决定 使 用 继承 而 不 是 复合 之 前 ， 还 应 该 问 上 自己 
最 后 一 组 问题 。 对 于 你 正 试 图 扩展 的 类 ， 它 的 
API 中 有 没有 缺陷 呢 ? WRA, Mena ER 
些 缺 陷 传播 到 类 的 API 中 ? 继承 机 制 会 把 超 类 
API 中 的 所 有 缺陷 传播 到 子 类 中 ， 而 复合 则 允许 
设计 新 的 API 来 隐藏 这 些 缺 陷 。 


简 而 言 之 ， 继 承 的 功能 非常 强大 ， 但 是 也 存在 诸 
多 问题 ， 因 为 它 违 背 了 封装 原则 。 只 有 当 子 类 和 








超 类 之 间 确 实 存在 子 类 型 天 系 是 ， 使 用 继承 才 是 
恰当 的 。 即 便 如 此 ， 如 果子 类 和 超 类 处 在 不 同 的 
包 中 ， 并 且 超 类 并 不 是 为 了 继承 而 设计 的 ， 那 么 
就 成 将 会 导致 脆弱 性 Cfragility) 。 为 了 避免 这 

种 脆弱 性 ， 可 以 用 复合 和 转发 机 制 来 代替 继承 ， 
尤其 是 当 存 在 适当 的 接口 可 以 实现 包装 类 的 时 

人 而 且 功 能 也 更 
[0 强大。 


第 17 条 : 要 么 为 继承 而 设 
计 ， 并 提供 文档 说 明 ， 要 
入 就 禁止 继承 


第 16 条 提醒 我 们 ， 对 于 不 是 为 了 继承 而 设计 、 并 
且 没 有 文档 说 明 的 “外 来 ”类 进行 子 类 化 是 多 么 危 
险 。 那 么 对 于 专门 为 了 继承 而 设计 并 且 具 有 展 好 
文档 说 明 的 类 而 言 ， 这 又 意味 着 什么 呢 ? 


首先 ， 访 类 的 文档 必须 精确 地 描述 禾 盖 每 个 方法 
所 市 来 的 影响 。 换 句 话 说 ， 该 类 必须 有 文档 说 明 
CARRA (overridable〉 的 方法 的 自用 性 (sel 
use) 。 对 于 每 个 公有 的 或 受 保护 的 方法 或 者 构 
造 器 ， 它 的 文档 必须 指明 该 方法 或 者 构造 器 调用 
了 哪些 可 宪 六 的 方法 ， 是 以 什么 顺序 调用 的 ， 
个 调用 的 结果 又 是 如 何 影响 后 续 的 处 理 过 程 的 
(Arig nJ% a Coverridable) 的 方法 ， 是 指 非 
final 的 ， 公 有 的 或 受 保护 的 ) 。 更 一 般 地 ， 类 
必须 在 文档 中 说 明 ， 在 哪些 情况 下 它 会 调用 可 徐 
兰 的 方法 。 例 如 ， 后 台 的 线程 或 者 静态 的 初始 化 
as (Cinitializer) 可 能 会 调用 这 样 的 方法 。 


fin, WRT AB a mA, EE 
的 文档 注释 末尾 应 该 包含 关于 这 些 调 用 的 描述 信 
轧 。 这 上 段 描述 信息 要 以 这 样 的 句子 开头 : “This 

implementation. 〈 该 实现 .……. ) ”。 这 样 的 句子 不 























应 该 被 认为 是 在 表明 该 行为 可 能 会 随 着 版 本 的 变 
迁 而 改变 。 它 意味 着 这 段 描述 关注 该 方法 的 内 部 
工作 情况 。 下 面 是 个 示例 ， 摘 自 


java.util.AbstractCollection 的 规范 ` 





public boolean remove(Object o) 


Removes a single instance of the specified 
element from this colletion, if it is 
present(optional operation). More formally, 
removes an element e such that (o==null ? e==nul 
: o.equals()) , if the collection contains one or 
more such elements. Returns true if the 
collection contained the specified element (or 
equivalently, if the collection changed as a 
result of the call). 


This implementation iterates over the collecting 
looking for the specified element. If it finds the 
elements, it removes the element from the 
collection using the iterators's remove method. 
Note that this implementation throws an 

UnsupportedOperationexception if the iterator 
returned by this collection's iterator method 
does not implement the remove method. 


CURIA Ra AEE TSE CR MP 

删除 该 指定 元 系 中 的 单个 实例 〈 这 是 项 可 选 
的 操作 ) 。 更 一 般 地 ， 如 果 集 合 中 包含 一 个 
或 者 多 个 这 样 的 元 素 *， 就 从 中 删除 这 种 元 
A 以 便 (o==null ? e==nul : o.equals()) 。 如 
果 集 合 中 包含 指定 的 元 了 素 就 返回 true CHM 
果 调 用 最 终 改变 了 集合 ， 也 一 样 )。 


该 实现 过 历 整 个 集合 来 查找 指定 的 元 素 。 如 
果 它 找到 该 元 素 ， 将 会 利用 迭代 器 的 remove 
方法 将 之 从 集合 中 删除 。 注 意 ， 如 果 由 该 集 
GH iterator 方法 返回 的 迭代 器 没有 实现 








remove 方法 ) 该 实现 就 会 抛 出 


UnsupportedOperationException o 


该 文档 清楚 地 说 明了 ， Fe a iterator 方法 将 会 影 
响 remove 方法 的 行为 。 而 且 ， 它 确切 地 描述 了 
iterator 方法 返回 的 Iterator 的 行为 将 会 怎样 影响 
remove 方法 的 行为 。 与 此 相反 的 是 ， 在 第 16 条 
的 情形 中 ， 程 序 员 在 子 类 化 Hashset 的 时 候 ， 并 
FOWL th add 方法 是 否 会 影响 ada 方法 
的 行为 。 


关于 程序 文档 有 人 句 格 言 : 好 的 API 文 档 应 该 描述 
一 个 给 定 的 方法 做 了 什么 工作 ， 而 不 是 描述 它 
是 如 何 做 到 的 。 那 么 ， 上 面 这 种 做 法 是 否 违背 
了 这 人 句 格 言 呢 ?” 是 的 ， 它 确实 违背 了 ! 这 正 是 继 
承 破 坏 了 封装 性 所 带 来 的 不 行 后 果 。 所 以 ， 为 了 
设计 一 个 类 的 文档 ， 以 便 它 能 够 安全 地 子 类 化 ， 
你 必须 擂 述 清楚 那些 有 可 能 未 定义 的 实现 细 市 。 


为 了 继承 而 进行 的 设计 不 仅仅 设计 自用 模式 的 文 
档 设 计 。 为 了 使 程序 员 能 够 编写 出 更 加 有 效 的 子 
形式 提供 适当 的 钩子 (hook) ， 以 便 能 够 进入 到 
它 的 内 部 工作 流程 中 ， 这 种 形式 可 以 是 精心 选择 
的 受 保护 的 《protected) 方法 ， 也 可 以 是 受 保护 
的 域 ， 后 者 比较 少见 。 人 例如， 考虑 


java.util.AbstractList 中 的 removeRange 方法 : 














protected void removeRange(int fromIndex, int 
toIndex) 


Removes from this list all of the elements 
whose index is between fromtndex , inclusive, 
and totndex , exclusive. Shifts any elements to 
the left (reduces their index). This call shortens 
the ArrayList by ( totndex - ‘fromIndex') 
elements. (If totndex==fromindex , this operation 
has no effect.) 


This method is called by the clear operation on 
this list and its sublists. Overriding this method 
to take advantage of the internals of the list 
implementation can substantially imporve the 
performance of the ciear operation on this list 
and its sublists. 


This implementation get a list iterator 
positioned before fromtndex and repeatedly 
calls Listrterator.next follows by 

ListIterator.remove , Until the entire range has 
been removed. Note: If Listzterator.remove 
requires linear time, this implementation 
requires quadratic time. 


Parameters: 
fromIndex index of first element to be removed. 


toIndex index after last element to be removed. 


(从 列表 中 删除 所 有 索引 处 于 fromIndex 
(E) 和 tomos CAA) 之 间 的 元 素 。 将 
所 有 符合 条 件 的 元 素 移 到 左边 《〈 减 小 索 
引 ) 。 这 一 调用 将 从 Arraytist 中 删除 C 
toIndex ~- fromIndex ) 之 间 的 元 素 。 (如 果 
toIndex == fromIndex  ， 这 项 操作 就 无 效 。 ) 


这 个 方法 是 通过 clear 操作 在 这 个 列表 及 其 
目 列表 中 调用 的 。 窗 新 这 个 方法 来 利用 列表 
实现 的 内 部 信息 ， 可 以 充分 地 改善 这 个 列表 
及 其 子 列表 中 的 crear 操作 的 性 能 。 


这 项 实现 获得 了 一 个 处 在 fromtndex 之 前 的 
列表 友 代 器 ， 并 一 次 地 重复 调用 
ListIterator.remove 和 ListIterator.next 35 直到 
整个 范围 都 被 移 除 为 止 。 注 意 : 如 果 
ListIterator.remove 需要 线性 的 时 间 ， 该 实现 











就 需要 平方 级 的 时 间 。 


fromIndex 要 移 除 的 第 : -个 元 素 的 索 引 





toIndex 要 移 除 的 最 后 : -个 元 素 之 后 的 索 
引 | ) 


这 个 方法 对 于 List 实现 的 最 终 用 户 并 没有 意 
义 。 提 供 该 方法 的 唯一 目的 在 于 ， 使 子 类 更 易于 
提供 针对 子 列 表 Csublist) 的 快速 crear 方法 。 
如 果 没 有 removerange 方法 ， 当 在 子 列表 
(sublist ) 上 调用 clear 方法 时 ， 子 类 将 不 得 不 
用 平方 级 的 时 间 (quadratic performance) 来 完成 
它 的 工作 。 盏 则 ， 就 得 重新 编写 整个 subList 机 制 
一 一 这 可 不 是 件 容 易 的 事情 ! 


因此 ， 当 你 为 了 继承 而 设计 类 的 时 候 ， 如 何 决定 
应 该 暴露 哪些 受 保护 的 方法 或 者 域 呢 ?遗憾 的 

是 ， 并 没有 神奇 的 法 则 可 供 你 使 用 。 你 所 能 做 到 
的 最 佳 途径 就 是 努力 思考 ， 发 挥 最 好 的 想象 ， 然 
后 编写 一 些 子 类 进行 测试 。 你 应 该 尽 可 能 少 地 暴 
露 受 保护 的 成 员 ， 因 为 每 个 方法 或 者 域 都 代表 了 
一 项 关于 实现 细节 的 承诺 。 另 一 方面 ， 你 又 不 能 
暴露 得 太 少 ， 因 为 漏 掉 的 受 保护 方法 可 能 会 导致 
这 个 类 无 法 被 真正 用 于 继承 。 


对 于 为 了 继承 而 设计 的 类 ， 唯 一 的 测试 方法 就 是 
MITRA. WRR S KEZAR, 
Ww T A BE Y PT eR AIA T E fE E H 
显 。 相 反 ， 如 果 编 写 了 多 个 子 类 ， 并 且 无 一 使 用 
受 保护 的 成 员 ， 或 许 就 应 该 把 它 做 成 私有 的 。 经 
验 表 明 ，3 个 子 类 通常 整 足 以 测试 一 个 可 扩展 的 
类 。 除 了 超 类 的 创建 者 之 外 ， 都 要 编写 一 个 或 者 
多 个 这 种 子 类 。 


在 为 了 继承 而 设计 有 可 能 被 广泛 使 用 的 类 时 ， 必 
































须要 意识 到 ， 对 于 文档 中 所 说 明 的 自用 模式 ( 

self-use pattern ) ， 以 及 对 于 其 受 保护 方法 和 域 
中 所 隐 伟 的 实现 策略 ， 你 实际 上 已 经 做 出 了 永久 
的 承诺。 这 些 承 诺 使 得 你 在 后 续 的 版 本 中 提高 这 
个 类 的 性 能 或 者 增加 新 功能 都 变 得 非常 困难 ， 甚 
至 不 可 能 。 因 此 ， 必须 在 发 布 类 之 前 先 编写 子 类 
对 类 进行 测试 。 


还 要 注意 ， 因 继承 而 需要 的 特殊 文档 会 打 乱 正常 
的 文档 信息 ， 普 通 的 文档 被 设计 用 来 让 程序 员 可 
以 创建 该 类 的 实例 ， 并 调用 类 中 的 方法 。 在 编写 
本 书 之 时 ， 几 乎 还 没有 适当 的 工具 或 者 注释 规 

范 ， 能 够 把 “普通 的 API 文 档 ” 与 “专门 针对 实现 子 
类 的 程序 员 的 信息 ”分 开 来 。 


为 了 允许 继承 ， 类 还 必须 遵守 其 他 一 些 约束 。 构 
造句 决 不 能 调用 可 被 禾 凋 的 方法 ， 无 论 是 直接 
调用 还 是 间接 调用 。 如 果 违 反 了 这 条 规则 ， 很 有 
可 能 导致 程序 失败 。 超 类 的 构造 器 在 子 类 的 构造 
LAZ MA, TAPERE EKR 
FEF RAM Ma ae tS LNH. WRZE 
it RAS TS OR FE ait TIA EY 
始 化 工作 ， 该 方法 将 不 会 如 预期 般 地 执行 。 为 了 
更 加 直观 地 说 明 这 一 点 ， 下 面 举 个 例子 ， 其 中 有 
个 类 违反 了 这 条 规则 : 


public class Super { 























// Broken - constructor invokes an overridable method 
public Super () { 
overrideMe(); 
public void overrideMe () { 


} 





下 i TXA M THG overrideMe » Super 唯一 
的 构造 器 就 错误 地 调用 了 这 个 方法 : 
public final class Sub extends Super { 


private final Date date; 
// Blank final, set by constructor 


Sub() { 


date = new Date(); 


// Overriding method invoked by superClass constructor 
@Override public void overrideMe () { 


System.out.println(date) ; 


public static void main (String[] args) 


Sub sub = new Sub(); 


sub.overrideMe(); 


你 可 能 会 期 待 这 个 程序 打印 出 日 期 两 次 ， 但 是 它 
第 一 次 打印 出 的 是 muta ， 因 为 overrideme 方法 被 
super 构造 器 调用 的 时 候 ， 构 造 右 sw 还 没有 机 
会 初始 化 date 域 。 注 意 ， 这 个 程序 观察 到 的 
final 域 处 于 两 种 不 同 的 状态 。 还 要 注意 ， 如 果 
overrideMe 己 经 调用 了 date 中 的 任何 方法 ， = 
Super 构造 器 调用 overrideMe 的 时 候 ， 调用 就 会 
抛 出 NullPointerException 异常 。 如 果 改 程序 没有 
抛 出 NullPointerException 异常 ， 唯一 的 原因 就 在 
T printin 方法 对 于 处 理 null 参数 有 着 特殊 的 规 
定 。 


在 为 了 继承 而 设计 类 的 时 候 ， cioneavie 和 
Serializable 接 H 出 现 了 特殊 的 困难 o 如 果 类 是 
为 了 继承 而 被 设计 的 ， 无 论 实现 这 其 中 的 哪个 接 
口 通 稼 都 不 是 个 好 主意 ， 因 为 它们 把 一 些 是 执行 
的 负担 转 怒 到 了 扩展 这 个 类 的 程序 员 的 号 上 。 然 
而 ， 你 还 是 可 以 采取 一 些 特殊 的 手段 ， 使 得 子 类 
实现 这 些 接口 ， 无 需 强 迫 子 类 的 程序 员 去 承受 这 
人 
X o 


如 果 你 决定 在 一 个 为 了 继承 而 设计 的 类 中 实现 

Cloneable 和 Serializable 接口 ， 就 应 该 意识 到 ， 

因为 clone 和 readobject 方法 在 行为 上 非常 类 似 
于 构造 器 ， 所 以 类 似 的 限制 规则 也 是 适用 的 : 无 
论 是 clone 还 是 readObject ， Als AS By DA il FA Ay 7 
mA AIA, ME EDA RR el ATT. 对 

于 readobject Ma, AARET EKET 
clone 方法 有 机 会 修正 被 元 隆 对 象 的 状态 之 前 被 
运行 。 无 论 哪 种 情形 ， 都 不 可 避免 地 将 导致 程序 
失败 。 在 clone 方法 的 情形 中 ， 这 种 失败 可 能 会 
同时 损害 到 原始 的 对 象 以 及 被 殉 隆 的 对 象 本 号 。 

例如 ， 如 果 和 窗 盖 版 本 的 方法 假设 它 正 在 修改 对 象 
深层 结构 的 克隆 对 象 的 备份 ， 就 会 发 生 这 种 情 

况 ， 但 是 该 备份 还 没有 完成 。 


最 后 ， 如 果 你 决定 在 一 个 为 了 继承 而 设计 的 类 中 
实现 Serializable ， 并 且 该 类 有 一 个 readResolve 
或 者 writeReplace 方法 ， 就 必须 使 用 readResolve 
或 者 writereplace 成 为 受 保护 的 方法 ， 而 不 是 私 
有 的 方法 。 如 果 这 些 方法 是 私有 的 ， 那 么 子 类 将 
会 不 声 不 啊 地 忽略 挥 这 两 个 方法 。 这 正 是 “为 了 
允许 继承 ， 而 把 实现 细节 变 成 一 个 类 的 API 的 一 
部 分 ”的 男 一 种 情形 。 


到 现在 为 止 ， 应 该 很 明显 : 为 了 继承 而 设计 类 ， 
对 这 个 类 会 有 一 些 是 实质 性 的 限制 。 这 并 不 是 
很 轻松 就 可 以 承 诡 的 决定 。 在 某 些 情况 下 ， 这 样 






































的 决定 很 明显 是 正确 的 ， 比 如 抽象 类 ， 包 括 接口 
的 骨架 实现 (skeletal implementation) 〈 见 第 18 
条 ) 。 但 是 ， 在 男 一 些 情况 下 ， 这 样 的 决定 却 很 
明显 是 错误 的 ， 比 如 不 可 变 的 类 《〈 见 第 15 条 ) 。 


但 是 ， 对 于 普通 的 具体 类 应 该 怎么 办 呢 ? 它们 既 
不 是 fina 的 ， 也 不 是 为 了 子 类 化 而 设计 和 编写 
文档 的 ， 所 以 这 种 状况 很 危险 。 每 次 对 这 种 类 进 
行 修改 ， 从 这 个 类 扩展 得 到 的 客户 类 残 有 可 能 让 
到 破坏 。 这 不 仅仅 是 个 理论 问题 。 对 于 一 个 并 非 
为 了 继承 而 设计 的 非 tina 具体 类 ， 在 修改 了 它 
的 内 部 实现 之 后 ， 接 收 到 与 子 类 化 相关 的 错误 报 
告 也 并 不 少见 。 


这 个 问题 的 最 佳 解决 方案 是 ， 对 于 那些 并 非 为 了 
安全 地 进行 子 类 化 而 设计 和 编写 文档 的 类 ， 要 茶 
止 子 类 化 。 有 两 种 办 法 可 以 禁止 子 类 化 。 比 较 
容易 的 办 法 是 把 这 个 类 声明 为 tina 的 。 男 一 种 
办 法 是 把 所 有 的 构造 器 部 变 成 私有 的 ， 或 者 包 级 
私有 的 ， 并 增加 一 些 公 有 的 静态 工矿 方法 类 蔡 代 
构造 器 。 后 一 种 办 法 在 第 15 条 中 讨论 过 ， 它 为 内 
ee 
ZH o 


这 条 建议 可 能 回 引 来 争议 ， 因 为 许多 程序 员 已 经 
习惯 于 对 普通 的 具体 类 进行 子 类 化 ， 以 便 增 加 新 
的 功能 设施 ， 比 如 仪表 功能 〈instrumentation， 

如 计数 显示 等 ) 、 通 知 机 制 或 者 同步 功能 ， 或 者 
为 了 限制 原 有 类 中 的 功能 。 如 果 类 实现 了 某 个 能 
够 反映 其 本 质 的 接口 ， 比 如 set 、 cist 或 者 

map > 就 不 应 该 为 了 禁止 子 类 化 而 感到 后 悔 。 第 
16 条 中 介绍 的 包装 类 (wrapper class) 模式 提供 
本 为 一 种 更 好 的 办 法 ， 让 继承 机 制 实现 更 多 的 功 
HE o 

如 果 具 体 的 类 没有 实现 标准 的 接口 ， 那 么 禁止 继 


承 可 能 会 给 有 些 程序 员 带 来 不 便 。 如 果 你 认为 必 
须 允 许 从 这 样 的 类 继承 ， 一 种 合理 的 办 法 是 确保 
































EPA aA ed AES A A PTI, HP 
在 文档 中 说 明 这 一 点 。 换 句 话 说 ， 完 全 消除 这 个 
类 中 可 窗 盖 方法 的 自用 特性 。 这 样 做 之 后 ， 残 可 
以 创建 “能 够 安全 地 进行 子 类 化 ”的 类 。 窗 盖 方 法 
将 永远 也 不 会 影响 到 其 他 任何 方法 的 行为 。 


你 可 以 机 械 地 消除 类 中 可 和 窗 盖 方法 的 自用 特性 ， 
而 不 改变 它 的 行为 。 将 每 个 可 和 窗 盖 的 代码 体 移 到 
一 个 私有 的 “辅助 方法 (helper method) ”中 ， 并 
有 旦 让 每 个 可 履 订 的 方法 调用 它 的 私有 辅助 方法 。 
然后 ， 用 “直接 调用 可 和 宪 新 方法 的 私有 辅助 方 

法 ”来 代 奉 “可 和 履 六 方 法 的 每 个 自 有 调用 ”。 








第 18 条 : 接口 优 于 抽象 类 


Java 程 序 设计 语言 提供 了 两 种 机 制 ， 可 以 用 来 定义 允许 多 个 实现 的 类 
型 : 接口 和 抽象 类 。 这 两 种 机 制 之 间 最 明显 的 区 别 在 于 ， 抽 和 象 类 允许 包 
含 某 些 方法 的 实现 ， 但 是 接口 则 不 允许 。 一 个 更 为 重要 的 区 别 在 于 ， 为 
了 实现 由 抽象 类 定义 的 类 型 ， 类 必须 成 为 抽象 类 的 一 个 子 类 。 任 何 一 个 
类 ， 只 要 它 定义 了 所 有 必要 的 方法 ， 并 且 遵 守 通 用 约定 ， 它 就 被 允许 实 
现 一 个 接口 ， 而 不 管 这 个 类 是 处 于 类 层次 〈class hierarchy) 的 哪个 位 
和 所 以 ， 抽 和 象 类 作为 类 型 定义 受到 了 极 大 的 
I} 。 


现 有 的 类 可 以 很 容易 被 更 新 ， 以 实现 新 的 接口 。 如 果 这 些 方法 尚 不 存 
在 ， 你 所 需要 做 的 就 只 是 增加 必要 的 方法 ， 然 后 在 类 的 声明 中 增加 一 个 
implements Fj. 例如 ， = Comparable 接口 被 引入 到 Java 平 台中 时 ， 会 更 
新 许多 现 有 的 类 ， 以 实现 Comparable 接口 。 一 般 来 说 ， 无 法 更 新 现 有 的 
类 来 扩展 新 的 抽象 类 。 如 果 你 希望 让 两 个 类 扩展 同一 个 抽象 类 ， 就 必须 
把 抽象 类 放 到 类 型 层次 (type hierarchy) 的 高 处 ， 以 便 这 两 个 类 的 一 个 
祖先 成 为 它 的 子 类 。 遗 憾 的 是 ， 这 样 做 会 间接 地 伤害 到 类 层次 ， 迫 使 这 














接口 是 定义 mixin 〈 混 合 类 型 ) 的 理想 选择 。 不 严格 地 将 ，mixin 是 指 
这 样 的 类 型 : 类 除了 实现 它 的 “基本 类 型 (primitive type) ”之 外 ， 还 可 
以 实现 这 个 mixin 接 口 ， 以 表明 她 提供 了 某 些 可 供 选择 的 行为 。 例 如 ， 
comparable 是 一 个 mixin 接 口 ， 它 允许 类 表明 它 的 实例 可 以 与 其 他 的 可 相 
互 比较 的 对 象 进行 排序 。 这 样 的 接口 之 所 以 被 称 为 mixin， 是 因为 它 允 
许 任 选 的 功能 可 被 混合 到 类 型 的 主要 功能 中 。 抽 象 类 不 能 被 用 于 定义 
mixin， 同 样 也 是 因为 它们 不 能 被 更 新 到 现 有 的 类 中 : 类 不 可 能 有 一 个 
以 上 的 父 类 ， 类 层次 结构 中 也 没有 适当 的 地 方 来 插入 mixin。 

接口 允许 我 们 构造 非 层次 结构 的 类 型 框架 。 类 型 层次 对 于 组 织 某 些 事 
物 是 非常 合适 的 ， 但 是 其 他 有 些 事 物 并 不 能 被 整齐 地 组 织 成 一 个 严格 的 
层次 结构 。 例 如 ， 假 设 我 们 有 一 个 接口 代表 一 个 singer《〈 和 歌唱 家 ) ， 男 
一 个 接口 代表 一 个 songwriter (fF HHA) : 


public interface Singer { 
































AudioClip sing (Song s) ; 


} 

public interface Songwriter f 
Song compose ( boolean init) ; 

} 





在 现实 生活 中 ， 有 些 歌唱 家 本 身 也 是 作曲 家 。 因 为 我 们 使 用 了 接口 而 不 
是 抽象 类 来 定义 这 些 类 型 ， 所 以 对 于 单个 类 而 言 ， 它 同时 实现 singer 
和 songwriter 是 完全 人 允许 的 。 实 际 上 ， 我 们 可 以 定义 第 三 个 接口 ， 它 同 
Singer 和 Songwriter ， 并 添加 了 一 些 适合 于 这 种 组 合 的 新 方 
法 : 








public interface SingerSongwriter extends Singer , Songwriter { 
AudioClip strum () ; 
void actSensitive () ; 


} 








你 并 不 总 是 需要 这 种 灵活 性 ， 但 是 一 旦 你 这 样 做 了 ， 接 口 就 成 了 救世 

主 ， 能 帮助 你 解决 大 问题 。 另 外 一 种 做 法 是 编写 一 个 及 和 肿 (bloated〉 的 
类 层次 ， 对 于 每 一 种 要 被 支持 的 属性 组 合 ， 都 包含 一 个 单独 的 类 。 如 果 
在 整个 类 型 系统 中 有 mn 个 属性 ， 那 么 就 必须 支持 $2^An$ 种 可 能 的 组 合 。 
这 种 现象 被 称 为 “组 合 爆炸 (combinatorial explosion) ”. XRRR SE 
导致 类 也 及 肿 ， 这 些 类 包含 许多 方法 ， 并 且 这 些 方法 只 是 在 参数 的 类 型 
上 有 所 不 同 而 已 ， 因 为 类 层次 中 没有 任何 类 型 体现 了 公共 的 行为 特征 。 


通过 第 16 条 中 介绍 的 包装 类 (wrapper class) 模式 ， 接口 使 得 安全 地 增 
强 类 的 功能 成 为 可 能 。 如 果 使 用 抽象 类 来 定义 类 型 ， 那 么 程序 员 除 了 
使 用 继承 的 手段 增加 功能 ， 没 有 其 他 的 选择 。 这 样 得 到 的 类 与 包装 类 相 
比 ， 功 能 更 差 ， 也 更 加 脐 弱 。 


虽然 接口 不 允许 包含 方法 的 实现 ， 但 是 ， 使 用 接口 来 定义 类 型 并 不 妨碍 
你 为 程序 员 提 供 实 现 上 的 帮助 。 通过 对 你 导出 的 每 个 重要 接口 都 提供 一 
个 抽象 的 骨架 实现 (skeletal implementation) 类， 把 接口 和 抽象 类 的 优 
点 结合 起 来 。 接 口 的 作用 仍然 是 定义 类 型 ， 但 是 骨架 实现 接管 了 所 有 
与 接口 实现 相关 的 工作 。 











按照 惯例 ， 上 骨架 实现 被 称 为 AbstractInterface ， 这 里 的 Interface 是 指 所 
实现 的 接口 的 名 字 。 例 如 ，Collections Framework 为 每 个 重要 的 集合 接 
口 都 提供 了 一 个 骨架 实现 ， 包括 AbstractCollection 、 AbstractSet 、 

AbstractList 和 AbstractMap o 将 他 们 称 作 SkeletalCollection 、 SkeletalSet 


、 SkeletalList 和 SkeletalMap 也 是 有 道理 的 ， 但 是 现在 Abstract 的 用 法 
己 经 根深 带 固 。 








如 果 涉 及 得 当 ， 骨 架 实现 可 以 使 程序 员 很 容易 提供 他 们 上 自己 的 接口 实 
现 。 例 如 ， 下 面 一 个 静态 工矿 方法 ， 它 包含 一 个 完整 的 、 功 能 全 面 的 
List 实现 : 
// Concrete implementation built atop skeletal implementation 
static List<Integer> intArrayAsList ( final int [] a) { 
if (a == null ) 


throw new NullPointerException(); 


return new AbstractList<Integer>() { 
public Integer get ( int i) { 


return a[i]; // Autoboxing (Item 5) 


@Override public Integer set ( int i, Integer val) { 
int oldVal = a[i]; 
a[i] = val; // Auto-unboxing 


return oldVal; // Autoboxing 


public int size () { 


return a.length; 


当 你 考虑 实现 一 个 List 实现 应 该 为 你 完成 哪些 工作 的 时 候 ， 可 以 
看 出 ， 这 个 例子 充分 演示 了 骨架 实现 的 强大 功能 。 顺 便 提 一 下 ， 这 
个 例子 是 个 Adapter[Gamma95，p.139]， 它 允许 将 int 数组 看 做 
Integer 实例 的 列表 。 由 于 在 int 值 和 Integer 实例 之 间 来 回转 化 
需要 开销 ， 它 的 性 能 不 会 很 好 。 注 意 ， 这 个 例子 中 只 提供 一 个 静态 
工厂 ， 并 且 这 个 类 还 是 个 不 可 被 访问 的 匿名 类 (anonymous class) 
〈 见 第 22 条 ) ， 它 被 隐藏 在 静态 工厂 的 内 部 。 


骨架 实现 的 美妙 之 处 在 于 ， 它 们 为 抽象 类 提供 了 实现 上 的 帮助 ， 但 
又 不 强加 “抽象 类 被 用 作 类 型 定义 时 ”所 特有 的 严格 限制 。 对 于 接口 
的 大 多 数 实现 来 讲 ， 扩 展 骨 染 实现 类 是 个 很 显然 的 选择 ， 但 并 不 是 
必需 的 。 如 果 预 置 的 类 无 法 扩展 骨架 实现 类 ， 这 个 类 始终 可 以 手工 
实现 这 个 接口 。 此 外 ， 上 骨架 实现 类 仍然 能 够 有 助 于 接口 的 实现 。 实 
现 了 这 个 接口 的 类 可 以 把 对 于 接口 方法 的 调用 ， 转 发 到 一 个 内 部 私 
有 类 的 实力 上 ， 这 个 内 部 私有 类 扩展 了 骨架 实现 类 。 这 种 方法 被 称 
VE 模拟 多 重 继承 (simulated multiple inheritance) ， 它 与 第 16 条 中 
讨论 的 包装 类 模式 密切 相关 。 这 项 技术 具有 多 重 继承 的 绝 大 多 数 优 
点 ， 同 时 又 避免 了 相应 的 缺陷 。 


编写 骨 以 实现 类 相对 比较 简单 ， 只 是 有 点 单调 乏味 。 首 先 ， 必 须 认 
真 研究 接口 ， 并 确定 哪些 方法 是 最 为 基本 的 Cprimitive) ， 其 他 的 
方法 则 可 以 根据 它们 来 实现 。 这 些 基 本 方法 将 成 为 骨架 实现 类 中 的 
抽象 方法 。 然 后 ， 必 须 为 接口 中 所 有 其 他 的 方法 提供 具体 的 实现 。 
例如 ， 下 面 是 map.entry 接口 的 骨架 实现 类 : 























// Skeletal Implementation 
public abstract class AbstractMapEntry <K, V> 
implements Map . Entry <K, V> { 
// Primitive operations 
public abstract K getKey () ; 


public abstract V getValue () ; 


// Entries in modifiable maps must override this method 
public V setValue (V value) { 


throw new UnsupportedOperationException(); 


// Implements the general contract of Map.Entry.equals 
@Override public boolean equals (Object o) { 
if (o == this ) 
return true ; 
if (! (o instanceof Map.Entry)) 
return false ; 
Map.Entry<?, ?> arg = (Map.Entry) o; 
return equals(getKey(), arg.getKey()) && 


equals(getValue(), arg.getValue()); 


private static boolean equals (Object 01, Object 02) { 


return o1 == null ? 02 == null : o1.equals(o2); 


// Implements the general contract of Map.Entry.hashCode 
@Override public int hashCode () { 


return hashCode(getKey()) ^ hashCode(getValue()); 


private static int hashCode (Object obj) { 


return obj == null ? © : obj.hashCode(); 





AAR We A S ARKA H AI eT A, APPA DEM oS 
17 条 中 介绍 的 所 有 关于 设计 和 文档 的 知道 原则 。 为 了 简短 起 
见 ， 上 面 例子 中 的 文档 注释 部 分 被 省 略 掉 了 ， 但 是 对 于 骨架 实 
现 类 而 言 ， 好 的 文档 绝对 是 非常 必要 的 。 


骨架 实现 上 有 个 小 小 的 不 同 ， 就 是 简单 实现 (simple 
implementation ) »  AbstractMap.SimpleEntry 就 是 个 例子 。 简单 实 
现 就 像 个 骨 织 实现 ， 这 是 因为 它 实现 了 接口 ， 并 且 是 为 了 继承 
而 设计 的 ， 但 是 区 别 在 于 它 不 是 抽象 的 : 它 是 最 简单 的 可 能 的 
eee ee etre ee Nee E E 


使 用 抽象 类 来 定义 允许 多 个 实现 的 类 型 ， 与 使 用 接口 相 比 有 一 
个 明显 的 优势 抽象 类 的 演变 比 接口 的 演变 要 容易 得 多 。 如 
果 在 后 续 的 发 行 版 本 中 ， 你 希望 在 抽象 类 中 增加 新 的 方法 ， 始 
终 可 以 增加 具体 方法 ， 它 包含 合理 的 默认 实现 。 然 后 ， 该 抽象 
类 的 所 有 现 有 实现 都 将 提供 这 个 新 的 方法 。 对 于 接口 ， 这 样 做 
征 行 不 通 的 。 


一 般 来 说 ， 要 想 在 公有 接口 中 增加 方法 ， 而 不 破坏 实现 这 个 接 
口 的 所 有 现 有 的 类 ， 这 是 不 可 能 的 。 之 前 实现 该 接口 的 类 将 会 
漏 掉 新 增加 的 方法 ， 并 且 无 法 再 通过 编译 。 在 为 接口 增加 新 方 
法 的 同时 ， 也 为 骨架 实现 类 增加 同样 的 新 方法 ， 这 样 可 以 在 一 
定 程 度 上 减 小 由 此 带 来 的 破坏 ， 但 是 ， 这 样 做 并 没有 真正 解决 
问题 。 所 有 不 从 骨架 实现 类 继承 的 接口 实现 仍然 会 遭 到 破坏 。 


因此 ， 设 计 公 有 的 接口 要 非常 谨慎 。 接口 一 旦 被 公开 发 行 ， 并 
且 已 被 广泛 实现 ， 再 想 改 变 这 个 接口 几乎 是 不 可 能 的 。 你 必 
须 在 初次 设计 的 时 候 就 保证 接口 是 正确 的 。 如 果 接 口 包 含 微小 
的 瑕 辛 ， 它 将 会 一 直 影 响 你 以 及 接口 的 用 户 。 如 果 接 口 具有 严 
重 的 缺陷 ， 它 可 以 导致 API 彻 底 失 败 。 在 发 行 新 接口 的 时 候 ， 
最 好 的 做 法 是 ， 在 接口 被 “冻结 "之 前 ， 尺 可 能 让 更 多 的 程序 员 
用 尽 可 能 多 的 方式 来 实现 这 个 新 接口 。 这 样 有 助 于 在 依然 可 以 
改正 缺陷 的 时 候 就 发 现 它们 。 


简 而 言 之 ， 接 口 通常 是 定义 允许 多 个 实现 的 类 型 的 最 佳 途径 。 
这 条 规则 有 个 例外 ， 即 当 演 变 的 容易 性 比 灵 活性 和 功能 更 为 重 
要 的 时 候 。 在 这 种 情况 下 ， 应 该 使 用 抽象 类 来 定义 类 型 ， 但 前 
提 是 必须 理解 并 且 可 以 接受 这 些 局 限 性 。 如 果 你 导出 了 一 个 重 
要 的 接口 ， 就 应 该 坚决 考虑 同时 提供 骨架 实现 类 。 最 后 ， 应 该 
尽 可 能 谨慎 地 设计 所 有 的 公有 接口 ， 并 通过 编写 多 个 实现 来 对 
它们 进行 全 面 的 测试 。 












































第 19 条 : 接口 只 用 于 定义 类 型 


当 类 实现 接口 时 ， 接 口 就 充当 可 以 引用 这 个 类 的 实例 的 类 型 
(type) 。 因 此 ， 类 实现 了 接口 ， 束 表明 客户 并 可 以 对 这 个 类 
i ene lee eee 








有 一 种 接口 被 称 为 常量 接口 (constant interface) ， 它 不 满足 
上 面 的 条 件 。 这 种 接口 没有 包含 任何 方法 ， 它 只 包含 静态 的 
final 域 ， 每 个 域 都 导出 一 个 常量 。 使 用 这 些 常 量 的 类 实现 这 
个 接口 ， 以 避免 用 类 名 来 修饰 常量 名 。 下 面 是 一 个 例子 : 


// Constant interface antipattern - do not use! 











public interface PhysicalConstants { 
// Avogadro's number (1/mol) 


static final double AVOGADROS_NUMBER = 6.02214199e23 ; 


// Boltzmann constant (J/K) 


static final double BOLTZMANN_CONSTANT = 1.3806503e-23 ; 


// Mass of the electron (kg) 


static final double ELECTRON_MASS = 9.10938188e-31 ; 





常量 接口 模式 是 对 接口 的 不 恨 使 用 。 类 在 内 部 使 用 茶 些 常 
量 ， 这 纯粹 是 实现 细节 。 实 现 常 量 接口 ， 会 导致 把 这 样 的 实现 
细节 泄露 到 该 类 导出 的 API 中 。 类 实现 常量 接口 ， 这 对 于 这 个 
类 的 用 户 来 讲 没有 什么 价值 。 实 际 上 ， 这 样 做 反而 会 使 他 们 更 
加 糊涂 。 更 糟 料 的 是 ， 它 代表 了 一 种 承诺 :如 果 在 将 来 的 太行 
版 本 中 ， 这 个 类 被 修改 了 ， 它 不 再 需要 使 用 这 些 常 量 了 ， 它 依 
然 必 须 实现 这 个 接口 ， 以 确保 二 进 制 羔 容 性 。 如 果 非 final 类 
实现 了 第 量 接 口 ， 它 的 所 有 子 类 的 命名 空间 也 会 被 接口 中 的 第 


量 所 “污染 "。 











在 Java 平 台 类 库 中 有 几 个 常量 接口 ， 例 如 
java.io.ObjectStreamConstants oœ 这 些 接口 应 该 被 认为 是 反面 的 典 


型 ， 不 值得 效仿 。 


如 果 要 导出 常量 ， 可 以 有 几 种 合理 的 选择 方案 。 如 果 这 些 常量 
与 某 个 现 有 的 类 或 者 接口 紧密 相关 ， 就 应 该 把 这 些 常量 添加 到 
这 个 类 或 者 接口 中 。 例 如 ， 在 Java 平 台 类 库 中 所 有 的 数值 包装 
类 ， 如 Integer 和 Double 5 都 导出 了 MIN_VALUE 和 MAX_VALUE 常 
量 。 如 果 这 些 和 常量 最 好 被 看 作 枚 举 类 型 的 成 员 ， 就 应 该 使 用 枚 
举 类 型 (enum type) 〈 见 第 30 条 ) 来 导出 这 些 常 量 。 否 则 ， 
应 该 使 用 不 可 实例 化 的 工具 类 (utility class) 〈 见 第 4 条 ) 来 
导出 这 些 和 常量。 下 面 的 例子 是 前 面 的 physicalconstants 例子 的 工 
有 具 类 翻版 : 


// Constant utility class 




















package com.effectivejava.science; 


public class PhysicalConstants { 


private PhysicalConstants () { } // Prevents instantiation 


public static final double AVOGADROS NUMBER = 
6.02214199e23 ; 


public static final double BOLTZMANN_CONSTANT = 
1.3806503e-23 ; 


public static final double ELECTRON_MASS = 
9.10938188e-31 ; 


} 





工具 类 通常 要 求 客 户 端 要 用 类 名 来 修饰 这 些 常 量 名 ， 例 如 
PhysicalConstants.AVOGADROS NUMBER o 如 果 大 量 利用 工具 类 导 出 的 
常量 ， 可 以 通过 利用 静态 导入 (static import) 机 制 ， 避 人 免 用 
类 名 来 修饰 第 量 名 ， 不 过 ， 静 态 导 入 机 制 是 在 Java 发 行 版 本 1.5 
中 才 引 入 的 : 


// Use of static import to avoid qualifying constants 


import static com.effectivejava.science.PhysicalConstants.*; 


public class Test { 
double atoms ( double mols) { 


return AVOGADROS_NUMBER * mols; 


// Many more uses of PhysicalConstants justify import 
简 而 言 之 ， 接 口 应 该 只 被 用 来 定义 类 型 ， 它 们 不 应 该 被 用 来 导 


第 20 条 : 类 层次 优 于 标签 类 


有 时 候 ， 可 能 会 遇 到 带 有 两 种 甚至 更 多 种 风格 的 实例 的 类 ， 并 
包含 表示 实例 风格 的 标签 Cag) 域 。 例 如 ， 考 虑 下 面 这 个 
类 ， 它 能 够 表示 圆 形 或 者 窍 形 : 

// Tagged class - vastly inferior to a class hierarchy 

class Figure { 


enum Shape { RECTANGLE, CIRCLE}; 


// Tag field - the shape of this figure 


final Shape shape; 
// These fields are used only if shape is RECTANGLE 
double length; 


double width; 


// This field is used only if shape is CIRCLE 


double radius; 


// Constructor for circle 


Figure( double radius) { 
shape = Shape.CIRCLE; 


this .radius = radius; 


// Constructor for rectangle 

Figure( double length, double width) { 
shape = Shape.RECTANGLE; 
this .length = length; 


this .width = width; 


double area () { 
switch (shape) { 
case RECTANGLE: 
return length * width; 
case CIRCLE: 
return Math.PI * (radius * radius); 
default : 


throw new AssertionError(); 





这 种 标签 类 (tagged class) 有 着 许多 缺点 。 它 们 中 充斥 
着 样板 代码 ， 包 括 枚 举 声 明 、 标 签 域 以 及 条 件 语 句 。 由 于 
多 个 实现 乱七八糟 地 挤 在 了 单个 类 中 ， 破 坏 了 可 读 性 。 内 
存 占用 也 增加 了 ， 因 为 实例 承担 着 属于 其 他 风格 的 不 相关 
的 域 。 域 不 能 做 成 是 final 的 ， 除 非 构 造 器 初始 化 了 不 相 
产生 更 多 的 样板 代码 。 构 造 器 必须 不 借助 编译 
， 来 设置 标签 域 ， 并 初始 化 正确 的 数据 域 : 如果 初 始 化 
w 程序 就 会 在 运行 时 失败 。 无 法 给 标签 类 添加 
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就 必须 级 的 给 每 个 条 件 语 名 都 添加 一 个 条 件 ， 人 否则 类 惑 会 
在 运行 时 失败 。 最 后 ， 实 例 的 数据 类 型 没有 提供 任何 关于 
其 风格 的 线索 。 一 句 话 ， 标签 类 过 于 见长 、 容 易 出 错 ， 并 
且 效 率 低下 。 


泣 运 的 是 ， 面 癌 对 象 的 语言 例如 Java， 就 提供 了 其 他 更 好 
的 方法 来 定义 能 够 表示 多 种 风格 对 象 的 单个 数据 类 型 : 字 
~ (subtyping) 。 标签 类 正式 类 层次 的 一 种 简单 的 仿 
XX o 


为 了 将 标签 类 转变 为 类 层次 ， 首 先 要 为 标签 类 中 的 每 个 方 
法 都 定义 一 个 包含 抽象 方法 的 抽象 类 ， 这 每 个 方法 的 行为 
都 依赖 于 标签 值 。 在 Figure 类 中 ， 只 有 一 个 这 样 的 方 
法 : area 。 这 个 抽象 类 是 类 层次 的 根 Coot) 。 如 果 还 有 
其 他 的 方法 其 行为 不 依赖 于 标签 的 值 ， 就 把 这 样 的 方法 放 
在 这 个 类 中 。 同 样 地 ， 如 果 所 有 的 方法 都 用 到 了 某 些 数据 
域 ， 就 应 该 把 它们 放 在 这 个 类 中 。 在 Figure 类 中 ， 不 存 
在 这 种 类 型 独立 的 方法 或 者 数据 域 。 


接 下 来 ， 为 每 种 原始 标签 类 都 定义 根 类 的 具体 子 类 。 在 前 
面 的 例子 中 ， 这 样 的 类 型 有 两 个 : 圆 形 〈circle) MEJA 

(rectangle) 。 在 每 个 子 类 中 都 包含 特定 于 该 类 型 的 数据 
域 。 在 我 们 的 示例 中 ， radius 是 特定 于 圆 形 的 ， 1ength 

和 wiath 是 特定 于 窍 形 的 。 同 时 在 每 个 子 类 中 还 包括 针对 
根 类 中 每 个 抽象 方法 的 相应 实现 。 以 下 是 与 原始 的 Figure 
类 相对 应 的 类 层次 : 


// Class hierarchy replacement for a tagged class 


























abstract class Figure { 


abstract double area () ; 


class Circle extends Figure { 


final double radius; 


Circle( double radius) { this .radius = radius; } 


double area () { return 
Math.PI * (radius * radius); } 


} 


class Rectangle extends Figure { 
final double length; 


final double width; 


Rectangle( double length, double width) { 
this .length = length; 


this .width = width; 


double area () { return length * width; } 


} 


这 个 类 层次 纠正 了 前 面 提 到 过 的 标签 类 的 所 有 缺点 。 
这 段 代 码 简 单 且 清楚 ， 没 有 包含 在 原来 的 版 本 中 所 见 
到 的 所 有 样板 代码 。 每 个 类 型 的 实现 都 配 有 自己 的 
类 ， 这 些 类 都 没有 受到 不 相关 的 数据 域 的 拖累 。 所 有 
的 域 都 是 final 的 。 编 译 器 确保 每 个 类 的 构造 器 都 初 
始 化 了 它 的 数据 域 ， 对 于 根 类 中 声明 的 每 个 抽象 方 
法 ， 都 确保 有 一 个 实现 。 这 样 就 杜绝 了 由 于 遗漏 
switch case 而 导致 运行 时 失败 的 可 能 性 。 多 个 程序 员 
可 以 独立 地 扩展 层次 结构 ， 并 且 不 用 访问 根 类 的 源 代 
人 码 就 能 相互 操作 。 每 种 类 型 都 有 一 种 相关 的 独立 的 数 
据 类 型 ， 允 许 程 序 员 指 明 变 量 的 类 型 ， 限 制 变量 ， 并 
将 参数 输入 到 特殊 的 类 型 。 


类 层次 的 妨 一 种 好 处 在 于 ， 它 们 可 以 用 来 反映 类 型 之 
间 本 质 上 的 层次 关系 ， 有 助 于 增强 灵活 性 ， 并 进行 更 
好 的 编译 时 类 型 检查 。 假 设 上 述 例子 中 的 标签 类 也 多 














许 表 达 正 方形 。 关 层次 可 以 反映 出 正方 形 也 是 一 种 特 
殊 的 矩形 这 一 事实 (假设 两 者 都 是 不 可 变 的 ): 
class Square extends Rectangle { 
Square( double side) { 


super (Side, side); 


} 





注意 ， 上 述 层 次 中 的 域 是 被 直接 访问 ， 而 不 是 通过 访 
问 方法 。 这 是 为 了 简洁 起 见 才 这 么 做 的 ， 如 果 层 次 结 
HESAR OMBUR) ， 则 不 允许 这 样 做 。 


简 而 言 之 ， 标 签 类 很 少 有 适用 的 时 候 。 当 你 想 要 编写 
一 个 包含 显 式 标签 域 的 类 时 ， 应 该 考虑 一 下 ， 这 个 标 
俭 是 人 否 可 以 被 取消 ， 这 个 类 是 人 否 可 以 用 类 层次 来 代 
蔡 。 当 你 遇 到 一 个 包含 标签 域 的 现 有 类 时 ， 就 要 考虑 
将 它 重 构 到 一 个 层次 结构 中 去 。 


第 21 条 : FY eA BOT ARAB IK 
各 


有 些 语言 支持 函数 指针 (function pointer) 、 代理 

(delegate) 、 lambda 表 人 达 式 (lambda expression) 

， 或 者 文 持 类 似 的 机 制 ， 允 许 程序 把 “调用 特殊 函数 
的 能 力 ” 存 储 起 来 并 传递 这 种 的 能 力 。 这 种 机 制 通 常 
允许 函数 的 调用 者 通过 传 入 第 二 个 函数 ， 来 指定 自己 
的 行为 。 例 如 ，C 语 言 标准 库 中 的 qsort 函数 要 求 用 
一 个 指 同 comparator (HERAS) 函数 的 指针 作为 参 

数 ， 它 用 这 个 函数 来 比较 待 排序 的 元 素 。 比 较 器 函数 
有 两 个 参数 ， 都 是 指向 元 素 的 指针 。 如 果 第 一 个 参数 
所 指 的 元 素 小 于 第 二 个 参数 所 指 的 元 素 ， 则 返回 一 个 
负 整 数 ， 如 果 两 个 元 素 相等 则 返回 零 ， 如 果 第 一 个 参 
数 所 指 的 元 素 大 于 第 二 个 参数 所 指 的 元 素 ， 则 返回 一 
个 正 整数 。 通 过 传递 不 同 的 比较 器 函数 ， 束 可 以 获得 




















各 种 不 同 的 排列 顺序 。 这 正 是 策略 〈Strategy) 模式 
[Gamma，p.315] 的 一 个 例子 。 比 较 器 函数 代表 一 种 为 
元 素 排序 的 策略 。 


Java 没 有 提供 函数 指针 ， 但 是 可 以 用 对 象 引用 实现 同 
样 的 功能 。 调 用 对 象 上 的 方法 通常 是 执行 该 对 象 
(that object) 上 的 某 项 操作 。 然 而 ， 我 们 也 可 能 定 
义 这 样 一 种 对 象 ， 它 的 方法 执行 其 他 对 象 《other 
objects) 【这些 对 象 被 显 式 传递 给 这 些 方法 ) 上 的 操 
作 。 如 果 一 个 类 仪 仅 导 出 这 样 的 一 个 方法 ， 它 的 实例 
实际 上 就 等 同 于 一 个 指 癌 该 方法 的 指针 。 这 样 的 实例 
被 称 为 函数 对 象 〈function object) 。 例 如 ， 考 虑 下 
面 的 类 : 


class StringLengthComparator { 





public LNE compare (String s1, String s2) { 


return si.length() - s2.length(); 


} 


这 个 类 导出 一 个 带 两 个 字符 串 参 数 的 方法 ， 如 果 第 一 
个 字符 串 的 长 度 比 第 二 个 的 短 ， 则 返回 一 个 负 整 数 ; 

如 果 两 个 字符 串 的 长 度 相 等 ， 则 返回 零 ， 如 果 第 一 个 
字符 串 比 第 二 个 的 长 ， 则 放 回 一 个 正 整 数 。 这 个 方法 
是 一 个 比较 器 ， 它 根据 长 度 来 给 字符 串 排序 ， 而 不 是 
根据 更 常用 的 字典 顺序 。 指 同 StringLengthComparator 对 
象 的 引用 可 以 被 当 作 是 一 个 指 回 该 比较 器 的 “函数 指 

F (function pointer) ”， 可 以 在 任意 一 对 字符 串 上 被 
调用 。 换 句 话说 ， StringLengthComparator 实例 是 用 于 字 
符 串 比较 操作 的 具体 策略 (concrete strategy) 。 


作为 典型 的 具体 策略 类 ， StringLengthComparator 类 是 无 
状态 的 (stateless) : 它 没 有 域 ， 所 以 ， 这 个 类 的 所 

有 实例 在 功能 上 都 是 相互 等 价 的 。 因 此 ， 它 作为 一 个 
Singleton 是 非常 合适 的 ， 可 以 节省 不 必要 的 对 象 创建 
开销 ( 见 第 3 条 和 第 5 条 ): 











class StringLengthComparator { 
private StringLengthComparator () { } 
public static final StringLengthComparator 
INSTANCE = new StringLengthComparator(); 
public int compare (String si, String s2) { 


return s1.length() - s2.length(); 


mE 


为 了 把 StringLengthComparator 实例 传递 给 方法 ， Try 大 二 
当 的 参数 类 型 。 使 用 StringLengthComparator 并 不 好 ， 
为 客户 站 将 无 法 传递 任何 其 他 的 比较 菏 略 。 相 反 ， 我 
们 需要 定义 一 个 comparator 接口 ， 并 修改 
StringLengthComparator 来 实现 这 个 接口 。 换 句 话说 ， 我 
们 在 设计 具体 的 策略 类 时 ， 还 需要 定义 一 个 SR 
(strategy interface) ， 如 下 所 示 : 


// Strategy interface 
public interface Comparator <T> { 


public anit compare (T t1, T t2) ; 


Comparator fe O HAA E NAE E java.util 包 
中 ， 但 是 这 并 不 神奇 ， 你 上 自己 也 完全 可 以 定义 它 。 
Comparator 接口 是 泛 型 (LEB 26% ) 的 ， 因此 它 适 合 
作为 除 字 符 串 之 外 的 其 他 对 象 的 比较 器 。 它 的 

compare 方法 的 两 个 参数 类 型 为 T CE 正常 的 参数 类 
型 ) ， 而 不 是 string 。 只 要 前 面 所 示 的 
StringLengthComparator 类 要 这 么 做 ， 就 可 以 用 它 实现 


Comparator<String> 接 O : 





class StringLengthComparator implements Comparator < 


String > { 


// class body is identical to the one shown above 


具体 的 集 略 类 往往 使 用 匿名 类 声明 (M223) 。 下 
面 的 语句 根据 长 上 度 对 一 个 字符 串 数组 进行 排序 : 


Arrays.sort(stringArray, new Comparator<String>() { 
public int compare (String si, String s2) { 


return s1.length() - s2.length(); 


3); 


但 是 注意 ， 以 这 种 方式 使 用 匿名 类 时 ， 将 会 在 每 次 执 
行 调 用 的 时 候 创 建 一 个 新 的 实例 。 如 有 果 它 被 重复 执 
行 ， 考 虑 将 函数 对 象 存储 到 一 个 私有 的 静态 final ER 
里 ， 并 重用 它 。 这 样 做 的 妨 一 种 好 处 是 ， 可 以 为 这 个 
函数 对 象 取 一 个 有 意义 的 域名 称 。 


因为 策略 接口 被 用 作 所 有 具体 策略 实例 的 类 型 ， 所 以 
我 们 并 不 需要 为 了 导出 具体 策略 ， 而 把 具体 策略 类 做 
成 公有 的 。 相 反 , “宿主 类 (host class) ”还 可 以 导出 
公有 的 静态 域 〈 或 者 静态 工厂 方法 ) ， 其 类 型 为 策略 
接口 ， 有 具体 的 策略 类 可 以 是 宿主 类 的 私有 航 套 类 。 下 
面 的 例子 使 用 静态 成 员 类 ， 而 不 是 匿名 类 ， 以 便 允 许 
具体 的 策略 类 实现 第 二 个 接口 Serializable : 


// Exporting a concrete strategy 








class Host { 
private static class StrLenCmp 


implements Comparator < String >, 
Serializable { 


public int compare (String s1, String s2) { 


return si1.length() - s2.length(); 





// Returned comparator is serializable 


public static final Comparator<String> 


STRING_LENGTH_COMPARATOR = new StrLenCmp(); 


. // Bulk of class omitted 


} 


string 类 利用 这 种 模式 ， 通 过 它 的 
CASE_INSENSITIVE_ORDER 域 ， 导 出 一 个 不 区 分 大 小 写 的 字 
符 串 比较 器 。 


简 而 言 之 ， 函 数 指针 的 主要 用 途 就 是 实现 策略 
(Strategy) 模式 。 为 了 在 Java 中 实现 这 种 模式 ， 要 声 
明 一 个 接口 来 表示 该 策略 ， 并 且 为 每 个 具体 策略 声明 
一 个 实现 了 该 接口 的 类 。 当 一 个 具体 策略 只 被 使 用 一 
次 时 ， 通 常 使 用 匿名 类 来 声明 和 实例 化 这 个 具体 策略 
类 。 当 一 个 具体 策略 类 是 设计 用 来 重复 使 用 的 时 候 ， 
它 的 类 通常 就 要 被 实现 为 私有 的 静态 成 员 类 ， 并 通过 
公有 的 静态 final 域 被 导出 ， 其 类 型 为 该 策略 接口 。 


第 22 条 : 优先 考虑 静态 成 员 
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REX (nested class) 是 指 被 定义 在 另 一 个 类 的 内 部 
的 类 。 髓 套 类 存在 的 目的 应 该 只 是 为 它 的 外 围 类 
enclosing class) 提供 服务 。 如 果 骨 套 类 委 凯 可 能 会 
用 于 其 他 的 某 个 环境 中 ， 它 就 应 该 是 顶层 类 (top- 
level class) . REXA WP: 静态 成 员 类 〈static 
member class) ~ 非 静 态 成 员 类 (nonstatic member 
class) ~ Æ% (anonymous class) 和 局 部 类 
(local class) 。 除 了 第 一 种 之 外 ， 其 他 三 种 都 被 称 
为 内 部 类 Cinner class) 。 本 条 目 将 告诉 你 什么 时 候 
应 该 使 用 哪 种 咀 套 类 ， 以 及 这 样 做 的 原因 。 


静态 成 员 类 是 最 简单 的 一 种 侍 套 类 。 最 好 把 他 看 作 和 是 
普通 的 类 ， 只 是 碰巧 被 声明 在 男 一 个 类 的 内 部 而 已 ， 
它 可 以 方位 外 围 类 的 所 有 成 员 ， 包 括 那 些 声 明 为 私有 

















的 成 员 。 毅 态 成 员 类 是 外 围 类 的 一 个 静态 成 员 ， 与 其 
他 静态 成 员 一 样 ， 也 遵守 同样 的 可 访问 性 规则 。 如 果 
它 被 声明 为 私有 的 ， 它 就 只 能 在 外 围 类 的 内 部 才 可 以 
被 访问 ， 等 等 。 


静态 成 员 类 的 一 种 常见 用 法 是 作为 公有 的 辅助 类 ， 仪 
当 与 它 的 外 部 类 一 起 使 用 时 才 有 意义 。 例 如 ， 考 虑 一 
个 枚 举 ， 它 描述 了 计算 器 支持 的 各 种 操作 ( 见 第 30 
条 ) o Operation 枚 举 应 该 是 Calculator ZENA A RRA 
成 员 ， 然 后 ， calculator 类 的 客户 端 束 可 以 用 诸如 
Calculator .Operation.PLUS 和 Calculator .Operation.MINUS 这 


样 的 名 称 来 引用 这 些 操作 。 


从 语法 上 讲 ， 静 态 成 员 类 和 非 静 态 成 员 类 之 间 唯 一 的 
区 别 是 ， 静 态 成 员 类 的 声明 中 包含 修饰 符 static o 

尽管 它们 的 语法 非常 相似 ， 但 是 这 两 种 舱 套 类 有 很 大 
的 不 同 。 非 静态 成 员 类 的 每 个 实例 都 隐 含 着 与 外 围 类 
的 一 个 外 围 实例 Cenclosing instance) 相关 联 。 在 非 
静态 成 员 类 的 实例 方法 内 部 ， 可 以 调用 外 围 实 例 上 的 
方法 ， 或 者 利用 修饰 过 的 this 构造 获得 外 围 实例 的 
引用 [JJLS，15.8.4]。 如 采 和 骨 套 类 的 实例 可 以 在 它 外 转 
类 的 实例 之 外 独立 存在 ， 这 个 髓 套 类 就 必须 是 静态 成 
TR: 在 没有 外 围 实 例 的 情况 下 ， 要 想 创建 非 静 态 成 
员 类 的 实例 是 不 可 能 的 。 


当 非 静态 成 员 类 的 实例 被 创建 的 时 候 ， 它 和 外 围 实例 
之 前 的 关联 关系 也 随 之 被 建立 起 来 ， 而且， 这 种 关联 
关系 以 后 不 能 被 修改 。 通 常情 况 下 ， 当 在 外 围 类 的 茶 
个 实例 方法 的 内 部 调用 非 静 态 成 原来 的 构造 费时 ， 这 
种 关联 关系 被 自动 建立 起 来 。 使 用 表达 式 
enclosingInstance.new MemberClass(args) 来 手工 建立 这 种 关 
联 关 系 也 是 有 可 能 的 ， 但 是 很 少 使 用 。 正 如 你 所 预料 
的 那样 ， 这 种 关联 关系 需要 消耗 非 静态 成 员 类 实例 的 
空间 ， 并 且 增 加 了 构造 的 时 间 开 销 。 


非 静 态 成 员 类 的 一 种 常见 用 法 是 定义 一 个 
Adapterp[Gamma95，p.139]， 它 允许 外 部 类 的 实例 被 
看 作 是 男 一 个 不 相关 的 类 的 实例 。 例 如 ， map 接口 的 















































实现 往往 使 用 非 静 态 成 员 类 来 实现 它们 的 集合 视图 
(collection view) ， 这 些 集合 视图 是 由 map 的 
keySet 、 entrySet 和 values 方法 返回 的 。 同样 地 ， 
诸如 set 和 List 这 种 集合 接口 的 实现 往往 也 使 用 非 
静态 成 员 类 来 实现 它们 的 迭代 器 (iterator) : 


// Typical use of a nonstatic member class 





public class MySet < E > extends AbstractSet <E > 


// bulk of the class omitted 


public Iterator<E> iterator () { 


reteurn new MyIterator () ; 


private class MyIterator implements Iterator 
<E> { 


如 打 声 明成 员 类 不 要 求 访问 外 于 实例 ， 就 要 始终 把 

static 修饰 符 放 在 它 的 声明 中 ， 使 它 成 为 静态 成 员 
类 ， 而 不 是 非 静 态 成 员 类 。 如 末 省 略 了 static 修饰 
符 ， 则 每 个 实例 都 将 包含 一 个 额外 的 指向 外 围 对 象 的 
引用 。 保 存 这 份 引 用 要 消耗 时 间 和 空间 ， 并 且 会 导致 
外 围 实例 在 符合 垃圾 回收 〈 见 第 6 条 ) 时 却 仍然 得 以 
保留 。 如 果 在 没有 外 围 实例 的 情况 下 ， 也 需要 分 配 实 
例 ， 丈 不 能 使 用 非 静态 成 员 类 ， 因 为 非 静 态 成 员 类 的 
实例 必须 要 有 一 个 外 于 实例 。 


私有 静态 成 员 类 的 一 种 常见 用 法 是 用 来 代 蔡 外 围 类 所 
代表 的 对 象 的 组 件 。 例 如 ， 考 虑 一 个 map 实例 ， 它 把 
键 〈key) AME Cvalue) 关联 起 来 。 许 多 map 实现 的 
内 部 都 有 一 个 Entry 对 象 ， 对 应 于 Map 中 每 个 键 - 值 
对 。 虽 然 每 个 entry 都 与 一 个 map 关联 ， 但 是 entry 




















BWIA ( getKey  » getValue 和 setvalue ) 并 不 需要 
访问 该 wp 。 因 此 ， 使 用 非 静态 成 员 来 表示 entry 是 

很 浪费 的 ， 私有 的 静态 成 员 类 是 最 佳 的 选择 。 如 果 不 
小 心 漏 掉 了 entry 声明 中 的 static 修饰 符 ， 该 map 仍 
然 可 以 工作 ， 但 是 每 个 entry 中 将 会 包含 一 个 指 癌 该 

wp 的 引用 ， 这 样 就 浪费 了 空间 和 时 间 。 


如 果 相关 的 类 是 导出 类 的 共有 的 或 受 保护 的 成 员 ， 毫 
无 疑问 ， 在 静态 和 非 静 态 成 员 类 之 间 做 出 正确 的 选择 
是 非常 重要 的 。 在 这 种 情况 下 ， 该 成 员 类 就 是 导出 的 
API 元 素 ， 在 后 续 的 发 行 版 本 中 ， 如 果 不 违反 二 进 制 
兼容 性 ， 就 不 能 从 非 静 态 成 员 类 变 为 静态 成 员 类 。 


匿名 类 不 同 于 Java 程 序 设 计 语 言 中 的 其 他 任何 语法 单 
元 。 正 如 你 所 想象 的 ， 匿 名 类 没有 名 字 。 它 不 是 外 围 
类 的 一 个 成 员 。 它 并 不 与 其 他 的 成 员 一 起 被 声明 ， 而 
古 在 使 用 的 同时 被 声明 和 实例 化 。 匿 名 类 可 以 出 现在 
代码 中 任何 允许 存在 表达 式 的 地 方 。 当 且 仅 当 匿 名 类 
出 现在 非 静 态 的 环境 中 时 ， 它 才 有 外 围 实 例 。 但 是 即 
使 它们 出 现在 静态 的 环境 中 ， 也 不 可 能 拥有 任何 静态 


成 员 。 


匿名 类 的 适用 性 受到 诸多 的 限制 。 除 了 在 它们 被 声明 
的 时 候 之 外 ， 是 无 法 将 它们 实例 化 的 。 你 不 能 执行 
instanceof 而 是 ， 或 者 做 任何 需要 命名 类 的 其 他 事 
情 。 你 无 法 声明 一 个 匿名 类 来 实现 多 个 借口 ， 或 者 扩 
展 一 个 类 ， 并 同时 扩展 类 和 实现 接口 。 匿 名 类 的 客户 
端 无 法 调用 任何 成 员 ， 除 了 从 它 的 超 类 型 中 继承 得 到 
之 外 。 由 于 匿名 类 出 现在 表达 式 中 ， 它 们 必须 保持 简 
短 7 大 约 10 行 或 者 更 少 些 一 一 否则 会 影响 程序 的 可 
读 性 。 


匿名 类 的 一 种 常见 用 法 是 动态 地 创建 函数 对 象 ( 
function object ， 见 第 21 条 。 例 如 ， 第 92 页 中 的 sort 
方法 调用 ， 利 用 匿名 的 comparator 实例 ， 根 据 一 组 字 
符 串 的 长 度 对 它们 进行 裴 请 。 匿 名 类 的 男 一 种 常见 用 
法 是 创建 过 程 对 象 (process object) ， 比 如 Runnable 
Thread 或 者 TimeTask 实例 。 第 三 种 常见 的 用 法 是 在 



























































静态 工厂 方法 的 内 部 〈 人 参见 第 18 条 中 的 intarrayastist 
IEN a 


RRE MWR ERKA HD ZS. EEM A 
声明 局 部 变量 ”的 地 方 ， 都 可 以 声明 局 部 类 ， 并 且 局 
部 类 也 遵守 同样 的 作用 域 规则 。 局 部 类 与 其 他 三 种 苦 
套 类 中 的 每 一 种 都 有 一 些 共 同 的 属性 。 与 成 员 类 一 

样 ， 局 部 类 有 名 字 ， 可 以 被 重复 地 使 用 。 与 匿名 类 一 
样 ， 只 有 当局 部 类 实在 非 静态 环境 中 定义 的 时 候 ， 才 
有 外 围 实 例 ， 它 们 也 不 能 包含 静态 成 员 。 与 匿名 类 一 
样 ， 它 们 必须 非常 简短 ， 以 便 不 会 影响 到 可 读 性 。 


简 而 言 之 ， 共 有 四 种 不 同 的 藤 套 类 ， 每 一 种 都 有 目 己 
的 用 途 。 如 果 一 个 馆 套 类 需要 在 单个 方法 之 外 仍然 是 
可 见 的 ， 或 者 太 长 了 ， 不 适合 于 放 在 方法 内 部 ， 就 应 
该 使 用 成 员 类 。 如 果 成 员 类 的 每 个 实例 都 需要 一 个 指 
器 其 外 围 实例 的 引用 ， 残 要 把 成 员 类 做 成 非 静 态 的 ; 
否则 ， 台 做 成 静态 的 。 假 设 这 个 蝶 套 类 属于 一 个 方法 
的 内 部 ， 如 果 你 只 需要 在 一 个 地 方 创 建 实 例 ， 并 且 已 
经 有 了 一 个 预 置 的 类 型 可 以 说 明 这 个 类 的 特征 ， 就 要 
把 它 做 成 匿名 类 ; 否则 ， 就 做 成 局 部 类 。 


第 5 章 yo Ay 


Java 1.5 发 行 版 本 中 增加 了 泛 型 (Generic) 。 在 没有 
泛 型 之 前 ， 从 集合 中 读 取 到 的 每 一 个 对 象 都 必须 进行 
转换 。 如 果 有 人 不 小 心 插 入 了 类 型 错误 的 对 象 ， 在 运 
行 时 的 转换 处 理 就 会 出 错 。 有 了 泛 型 之 后 ， 可 以 告诉 
编译 器 每 个 集合 中 接受 哪些 对 象 类 型 。 编 译 占 上 自动 地 
为 你 的 插入 进行 转化 ， 并 在 编译 时 告知 是 否 插 入 了 类 
型 错误 的 对 象 。 这 样 可 以 使 程序 既 更 加 安全 ， 也 更 加 
清楚 ， 但 是 要 享有 这 些 优势 有 一 定 的 难度 。 本 章 就 是 
教 你 如 何 最 大 限度 地 享有 这 些 优势 ， 又 能 使 整个 过 程 
尽 可 能 地 简单 化 。 有 关 这 部 分 内 容 的 详情 ， 请 参见 

Langer 的 教程 [Langer08]， 或 者 Naftalin 和 Walder 合 
= h9 B[Naftalin07]. 


























第 23 条 : 请 不 要 在 新 代码 中 
使 用 原生 态 类 型 


先 来 介绍 一 些 术 语 。 声 明 中 具有 一 个 或 者 多 个 类 型 参 
4X (type parameter) 的 类 或 者 接口 ， 就 是 泛 型 
(generic) 类 或 者 接口 ULS，8.1.2，9.1.2]。 例 如 ， 
从 Java 1.5 发 行 版 本 起 ， uist 接口 就 只 有 单个 类 型 参 
Me ， 表 示 列 表 的 元 素 类 型 。 从 技术 的 角度 来 看 ， 
这 个 接口 的 名 称 应 该 是 指 现 在 的 Liste CRIE“ E 
的 列表 ”) ， 但 是 人 们 经 第 把 它 简称 为 List 。 泛 型 类 
和 接口 统称 为 泛 型 (generic type) 。 


每 种 泛 型 定义 一 组 参数 化 的 类 型 (parameterized 
type) ， 构 成 格式 为 : 显示 类 或 者 接口 的 名 称 ， 接 着 
FARTS C < > ) 把 对 应 于 泛 型 形式 类 型 参数 的 实际 
类 型 参数 列表 [JLS，4.4，4.5] 括 起 来 。 例 如 ， 
List<string> 《〔 读 作 “ 字 符 串 列表 ”) 是 一 个 参数 化 的 
类 型 ， 表 示 元 素 类 型 为 string 的 列表 。 ( string 是 
与 形式 类 型 参数 E 相对 应 的 实际 类 型 参数 。) 


最 后 一 点 ， 每 个 泛 型 都 定义 了 一 个 原生 态 类 型 Craw 
type) ， 即 不 带 任何 实际 类 型 参数 的 泛 型 名 称 [JLS， 
4.8]。 例 如 ， 与 riste 相对 应 的 原生 态 类 型 是 List 
。 原 生态 类 型 就 像 从 类 型 声明 中 删除 了 所 有 泛 型 信息 
一 样 。 实 际 上 ， 原 生态 类 型 List 与 Java 平 台 没 有 泛 
型 之 前 的 接口 类 型 List 完全 一 样 。 


在 Jave 1.5 版 本 发 行 之 前 ， 以 下 集合 声明 是 值得 参考 
oe 


























// Now a raw collection type don't do this 


* My stamp collection. Contains only Stamp instances. 


private final Collection stamps = ...; 


如 果 一 不 小 心 将 一 个 coin 放 进 了 stamp 集合 中 ， 这 一 
eae 运行 并 且 不 会 出 现任 何 错 
TREE: 





// Erroeous insertion of coin into stamp collection 


stamps.add( new Coin(...)); 


直到 从 stamp 集合 中 获取 coin 时 才 会 收 到 错误 提示 : 


// Now a raw iterator type - don't do this! 
for (Iterator i = stamps.iterator(); i.hashNext(); ) { 


Stamp s = (Stamp) i.next(); 
// Throws ClassCastException 


// Do something with the stamp 


束 如 本 书 中 经 和 常 提 到 的 ， 出 错 之 后 应 该 尽快 发 现 ， 最 
好 是 编译 时 就 发 现 。 本 例 中 ， 直 到 代码 运行 时 才 发 现 
错误 ， 已经 出 错 很 入 了 ， 而 且 你 在 代码 中 所 处 的 位 置 
距离 包含 错误 的 这 部 分 代码 已 经 很 远 了 。 一 旦 发 现 
le ’ 就 必须 搜索 代码 ， 查找 将 coin 放 
进 stamp 集合 的 方法 调用 。 此 时 编译 器 帮 不 上 忙 ， 因 
为 它 无 法 理解 这 种 注释 : “Contains only Stamp 
instances 《只 包含 stamp 实例 ) ”。 


有 了 泛 型 ， 岗 可 以 利用 改进 后 的 闫 型 声明 来 代 谷 集合 
这 种 注释 ， 告 诉 编译 器 之 前 的 注释 中 所 隐 含 的 信 


I® es 











// Parameterized collection type - typesafe 


private final Collection<Stamp> stamps = ... ; 


通过 这 条 声 明 ， 编译 器 知道 stamps 应 该 只 4 包含 Stamp 
实例 ， 并 给 予 保证 ， 假 设 整个 代码 是 利用 Java 1.5 及 


其 之 后 版 本 的 编译 器 进行 编译 的 ， 所 有 代码 在 编译 过 
程 中 都 没有 发 出 (或 者 禁止 ， 请 见 第 24 条 ) 任何 警 
告 。 当 stamps 利用 一 个 参数 化 的 类 型 进行 声明 时 ， 
音 误 的 插入 会 产生 一 条 编译 时 的 错误 消息 ， 准 确 地 告 
诉 你 哪里 出 错 了 : 


Test.java: 9 : add(Stamp) 
in Collection<Stamp> cannot be applied 


to (Coin) 
stamps. add (new Coin() ) 


A 





IBA AdE MRA PARIA EY AS Fg BEAT 
FLIER 了。 编译 器 会 丛 你 插入 隐 式 的 转换 ， 并 确保 
它们 不 会 失败 (依然 假设 所 有 代码 部 是 通过 支持 泛 型 
的 编译 器 进行 编译 的 ， 并 且 没 有 产生 或 者 禁止 任何 警 
告 ) 。 无 论 你 是 否 使 用 for-each 循环 〈 见 第 46 条 ) ， 
上 述 功能 都 适用 : 

// for- 

each loop over a parameterized collection - typesafe 


for (Stamp s : stamps) { // No cast 


// Do something with the stamp 


或 者 无 论 是 否 使 用 传统 的 for 循环 也 一 样 : 
// for loop with parameterized iterator declaration - typesafe 


for 
(Iterator<Stamp> i = stamps.iterator(); i.hasNext(); ) { 


Stamp s = i.next(); // No cast necesary 


// Do something with the stamp 


有 点 牵强 ， 但 这 类 问题 确实 真实 的 。 例 如 ， 很 容易 想 


象 有 人 会 不 小 心 将 一 个 java.util.vate 实例 放 进 一 个 原 
本 只 包含 java.sqi.vate 实例 的 集合 中 。 


如 上 所 述 ， 如 果 不 提供 类 型 参数 ， 使 用 集合 类 型 和 其 
他 泛 型 也 仍然 是 合法 的 ， 但 是 不 应 该 这 么 做 。 如 果 使 
用 原生 态 类 型 ， 就 失掉 了 泛 型 在 安全 性 和 表述 性 方面 
的 所 有 优势 。 既 然 不 应 该 使 用 原生 态 类 型 ， 为 什么 
Java 的 设计 者 还 要 允许 使 用 它们 呢 ? 这 是 为 了 提供 兼 
容 性 。 因 为 泛 型 出 现 的 时 候 ，Java 平 台 即 将 进入 它 的 
第 二 个 10 年 ， 已 经 存在 大 量 没 有 使 用 方形 的 Java 代 
码 。 人 们 认为 让 所 有 的 代码 保持 合法 ， 并 且 能 够 与 使 
用 泛 型 的 新 代码 互 用 ， 这 一 点 很 重要 。 它 必须 合法 ， 
才能 将 参数 化 类 型 的 实例 传递 给 那些 被 设计 成 使 用 普 
通 类 型 的 方法 ， 反 之 亦 然 。 这 种 需求 被 称 作 移植 兼容 
性 (Migration Compatibility) ， 促 成 了 文 持原 生态 类 
型 的 决定 。 


虽然 不 应 该 在 新 代码 中 使 用 像 List 这 样 的 原生 态 类 
型 ， 使 用 参数 化 的 类 型 以 允许 插入 任意 对 象 ， 如 
List<Object>  ， 这 还 是 可 以 的 。 原生 态 类 型 List 和 和 
参数 化 的 类 型 List<object> 之 间 到 底 有 什么 区 别 呢 ? 
不 严格 地 说 ， 前 者 逃避 了 泛 型 检查 ， 后 者 则 明确 告知 
编译 器 ， 它 能 够 持 有 任意 类 型 的 对 象 。 虽 然 你 可 以 将 
List<String> 传递 给 List 的 参数 ， 但 是 不 能 讲 它 传 给 
类 型 List<opject> 的 参数 。 泛 型 有 子 类 型 化 
(subtyping) 的 规则 ， List<string> 是 原生 态 类 型 
List NS FR, 而 不 是 参数 化 类 型 List<Object> 
的 子 类 型 〈 见 第 25 条 ) 。 因 此 ， 如 果 使 用 像 List 这 
样 的 原生 态 类 型 ， 就 会 失 挥 类 型 安全 性 ， 但 是 如 果 使 
FAR List<opject> 这 样 的 参数 化 类 型 ， 则 不 会 。 


为 了 更 具体 地 进行 说 明 ， 请 参考 下 面 的 程序 : 


// Uses raw type (List) fails at runtime! 











public static void main (String[] args) { 
List<String> strings = new ArrayList<String>(); 


unsafeAdd(strings, new Integer( 42 )); 


String s = strings.get( © ); // Compiler- 
generated cast 


} 


private static void unsafeAdd (List list, Object o) 


list.add(o); 





这 个 程序 可 以 进行 编译 ， 但 是 因为 它 使 用 了 原生 态 类 


型 List ， 你 会 收 到 一 条 警 告 : 


Test.java: 10 : warning: unchecked call to add (E) 
in raw type list 


list, add (0) B 


A 


实际 上 ， 如 果 运 行 这 段 程序 ， 在 程序 试图 将 
strings.get(0) 的 调用 BARRAR =e String 时 ， 会 
收 到 一 个 ClassCastException 异常 。 REAREA 
成 的 转换 ， 因 此 一 般 保 证 会 成 功 ， 但 是 我 们 在 这 个 例 
子 中 忽略 了 一 条 编译 器 警告 ， 就 会 为 此 而 付出 代价 。 


如 果 在 unsafeadd 声明 中 使 用 参数 化 类 型 List<object> 
代 蔡 原生 态 类 型 us ， 并 试 着 重新 编译 这 段 程序 ， 
会 发 现 它 无 法 再 进行 编译 了 。 以 下 是 它 的 错误 消息 : 


Test.java: 5 : unsafeAdd(List<Object>, Object) 
cannot be applied 








to (List<String>, Integer) 
unsafeAdd (strings, new Integer(42) ) ; 


A 


在 不 确定 或 者 不 在 乎 集合 中 的 元 素 类 型 的 情况 下 ， 你 
也 许 会 使 用 原生 态 类 型 。 假设 想 要 编写 一 个 方 
法 ， 它 有 两 个 集合 〈 se ) ， 并 从 中 返回 它们 共有 的 
CRMC. MAUS 不 不 熟悉 的 话 ， 可 以 参考 


一 下 方式 来 编写 这 种 方法 : 
// Use of raw type for unknown element type - don't do this! 
static int numElementsInCommon (Set s1, Set s2) { 
int result = 0; 
for (Object o1 : s1) 
if (s2.contains(o1)) 
result++; 


return result; 


这 个 方法 倒是 可 以 ， 但 它 使 用 了 原生 态 类 型 ， 这 是 很 
危险 的 。 从 Java 1.5 发 行 版 本 开始 ，Java 束 提供 了 一 种 
安全 的 蔡 代 方 法 ， 称 作 无 限制 的 通配符 类 型 
(unbounded wildcard type) 。 如 果 要 使 用 泛 型 ， 但 
不 确定 或 者 不 关心 实际 的 类 型 参数 ， 就 可 以 使 用 一 个 
问号 代替 。 例 如 ， 泛 型 set 的 无 限制 通配符 类 型 
为 set<?> 【〔 读 作 “ 某 个 类 型 的 集合 ”) 。 这 是 最 普通 的 
参数 化 set 类 型 ， 可 以 持 有 任意 集合 。 下 面 是 
numElementsInCommon 方法 使 用 了 无 限制 通配符 类 型 时 的 


情形 : 


// Unbounded wildcard type - typesafe and flexible 














static int numElementsInCommon (Set<?> si, Set<?> s2) 


int result = 0; 
for (Object o1 : s1) 
if (s2.contains(o1)) 


resultt++; 


return result; 


在 无 限制 通配符 类 型 set<?。 和 原生 态 类 型 set 之 间 
有 什么 区 别 呢 ? 这 个 问号 真正 起 到 作用 了 吗 ? 这 一 点 
不 需要 歼 述 ， 但 通配符 类 型 是 安全 的 ， 原 生态 类 型 则 


不 安全 。 由 于 可 以 将 任何 元 素 放 进 使 用 原生 态 类 型 的 
集合 中 ， 因 此 很 容易 破坏 该 集合 的 类 型 约束 条 件 〈 如 
第 100 页 的 例子 中 所 示 的 unsafendd 方法 ) ; 但 不 能 将 
CEA TCR ORI nu 之 外 ) 放 到 `Collection<?> 
中 。 如 果 尝 试 这 么 做 的 话 ， 将 会 产生 一 条 像 这 样 的 编 
译 时 错误 消息 : 

WildCard.java: 13 : cannot find symbol 

symbol : method add (String) 

location: interface Collection<capture#825 of ?> 


c. add ( "verboten" ) ; 


这 样 的 错误 消息 显然 还 无 法 令 人 满意 ， 但 是 编译 器 已 
经 尽 到 了 它 的 职责 ， 防 止 你 破坏 集合 的 类 型 约束 条 
件 。 你 不 仅 无 法 将 任何 元 素 (除了 nu 之 外 ) 放 进 
Collection<?> 中 ， 而 且 根 本 无 法 猜测 你 会 得 到 哪 种 类 
型 的 对 象 。 要 是 无 法 接受 这 些 限制 ， 就 可 以 使 用 汉 型 
方法 (generic method， 见 第 27 条 ) 或 者 有 限制 的 通 
配 符 类 型 (bounded wildcard type， 见 第 28 条 ) 。 


不 要 在 新 代码 中 使 用 原生 态 类 型 ， 这 条 规则 有 两 个 小 
小 的 例外 ， 两 者 都 源 于 “ 泛 型 信息 可 以 在 运行 时 被 擦 
除 ”( 见 第 25 条 ) 这 一 事实 。 在 类 文字 (dlass 
literal) 中 必须 使 用 原生 态 类 型 。 规 范 不 允许 使 用 参 
数 化 类 型 (虽然 允许 数组 类 型 和 基本 类 型 )[JLS， 
15.8.2]。 换 句 话说 ， List.class 35 String[].class 和 
int.class 都 合法 ， 但 是 List<String.class> 和 List<? 


>.class 则 BBE o 


这 条 规则 的 第 二 个 例外 与 instanceof BRIE TEA Ko 由 
于 泛 型 信息 可 以 在 运行 时 被 控 除 ， 因 此 在 参数 化 类 型 
而 非 无 限制 通配符 类 型 上 使 用 instanceof 操作 符 是 非 
法 的 。 用 无 限制 通配符 类 型 代 蔡 原生 态 类 型 ， 对 

instanceof 操作 符 的 行为 不 会 产生 任何 影响 。 在 这 种 
情况 下 ， 尖 括号 ( <> ) 和 问号 ( ? ) 就 显得 多 余 
Je 下 面 是 利用 泛 型 来 使 用 instanceof 操作 符 的 首选 





























方法 : 


// Legitimate use of raw type - instanceof operator 

if (o instanceof Set) { // Raw type 
Set<?> m = (Set<?>) 0; // Wildcard type 

} 


注意 ， 一 旦 确定 这 个 o 是 个 set ， 就 必须 将 它 转换 
成 通配符 类 型 set<>> ， 而 不 是 转换 成 原生 态 类 型 set 
。 这 是 个 受 检 的 (checked) 转换 ， 因 此 不 会 导致 编 

译 时 警告 。 


总 之 ， 使 用 原生 态 类 型 会 在 运行 时 导致 异常 ， 因 此 不 
要 在 新 代码 中 使 用 。 原 生态 类 型 只 是 为 了 与 引入 泛 型 
之 前 的 遗留 代码 进行 兼容 和 互 用 而 提供 的 。 让 我 们 做 
个 快速 的 回顾 : 。 set<object> 是 个 参数 化 类 型 ， 表 示 可 
以 包含 任何 对 象 类 型 的 一 个 集合 ; set 则 是 一 个 
通配符 类 型 ， 表 示 只 能 包含 某 种 未 知 对 象 类 型 的 一 个 
集合 ; st 则 是 个 原生 态 类 型 ， 它 脱离 了 泛 型 系统 。 
前 两 种 是 安全 的 ， 最 后 一 种 不 安全 。 


为 便于 参考 ， 表 5-1 概括 了 本 条 目 中 所 介绍 的 术语 
〈 及 本 章 其 他 条 目 中 介绍 的 一 些 术语 ) : 


表 5-1 本 章 条 目 中 所 介绍 的 术语 























AL 
术语 示例 
参数 化 的 类 型 List<String> 第 23 条 
实际 类 型 参数 string 第 23 条 
yz AY Listes 5323, 26 


条 


形式 类 型 参数 
无 限制 通配符 
类型 
原生 态 类 型 
有 限制 类 型 参 
数 
递归 类 型 参数 
有 限制 通配符 
类 型 

泛 型 方法 


类 型 令 牌 


E 


List<?> 


List 


<E extends Number> 


<T extends 
Comparable<T>> 


List<? extends Number> 


static <E> List<E> 


asList(E[] 


a) 


String.class 


第 23 条 
第 23 条 


第 23 条 
第 26 条 


第 27 条 
第 28 条 
第 27 条 


第 29 条 


第 24 条 : WRIA E 


用 泛 型 编程 时 ， 会 遇 到 许多 编译 器 警告 : 非 受 检 强 制 
转化 警告 (unchecked cast warnings) 、 非 受 检 方 法 调 
用 警告 、 非 受 检 普 通 数 组 创建 警告 ， 以 及 非 受 检 和 转换 


警告 (unchecked conversion warnings) 。 当 你 越 来 越 


熟悉 泛 型 之 后 ， 遇 到 的 警告 也 会 越 来 越 少 ， 但 是 不 要 





期 符 从 一 开始 用 泛 型 编写 代码 吏 可 以 正确 地 进行 纺 


译 。 





有 许多 非 受 检 警 告 很 容易 消除 。 例 如 ,假设 意 外 地 编 


写 了 这 样 一 个 声明 : 


Set<Lark> exaltation = new 


HashSet(); 


编译 器 会 细致 地 提醒 你 哪里 出 错 了 : 


Venery.java: 4 : 


warning: 


found : HashSet, required: Set<Lark> 


Set<Lark> exaltation = 


A 


new HashSet(); 


[unchecked] unchecked conversion 


你 就 可 以 纠正 所 显示 的 错误 ， 消 除 和 警告 : 


Set<Lark> exaltation = new HashSet<Lark>(); 


有 些 警告 比较 难以 消除 。 本 章 主要 介绍 这 种 警告 的 
示例 。 当 你 遇 到 需要 进行 一 番 思 考 的 警告 时 ， 要 坚持 
住 ! 要 尽 可 能 地 消除 每 一 个 非 受 检 和 警告 。 如 果 消 除 
了 所 有 和 警告， 就 可 以 确保 代码 是 类 型 安全 的 ， 这 是 一 
件 很 好 的 事情 。 这 意味 着 不 会 在 运行 时 出 现 
classcastException 异常 ， 你 会 更 加 自信 目 己 的 程序 可 
以 实现 预期 的 功能 。 


如 果 无 法 消除 警告 ， 同 时 可 以 证 明 引 起 警告 的 代码 是 
类 型 安全 的 ，《 只 有 在 这 种 情况 下 才 ) 可 以 用 一 个 

@SuppressWarnings ("unchecked") 注解 来 禁止 这 条 警告 o 如 
果 在 禁止 警告 之 前 没有 先 证 实 代 码 是 类 型 安全 的 ， 那 
束 只 是 给 你 自己 一 种 错误 的 安全 感 而 已 。 代 码 在 编译 
的 时 候 可 能 没有 出 现任 何 警 告 ， 但 它 在 运行 时 仍然 会 
抛 出 ClassCastException 异常 了 但 是 如 果 忽 略 (而 不 是 
茶 止 》 明 知道 是 安全 的 非 受 检 警 告 ， 那 么 当 新 出 现 一 
条 真正 有 问题 的 警告 时 ， 你 也 不 会 注意 到 。 新 出 现 的 
警告 就 会 淹没 在 所 有 的 错误 警告 当中 。 


suppresswarnings 注解 可 以 用 在 任何 粒度 的 级 别 中 ， 从 
单独 的 局 部 变量 声明 到 整个 类 都 可 以 。 应 该 始终 在 尽 
可 能 小 的 范围 中 使 用 SuppressWarnings 注解 。 它 通常 
是 个 变量 声明 ， 或 是 非常 简短 的 方法 或 者 构造 器 。 
永远 不 要 再 整个 类 上 使 用 SuppressWarnings 注解 ， XA 
(A) paean S ERBE. 


如 果 你 发 现 自己 在 长 度 不 止 一 行 的 方法 或 者 构造 器 中 
使 用 SuppressWarnings 注解 ， 可 以 将 它 移 到 一 个 局 部 变 
量 的 声明 中 。 虽 然 你 必须 声明 一 个 新 的 局 部 变量 ， 不 
过 这 么 做 还 是 值得 的 。 例 如 ， 考 虑 Arraytist 类 当中 
的 toArray 方法 : 


























public <T> toArray(T[] a) { 


if (a.length < size) 


return 
(T[]) Arrays.copyOf(elements, size, a.getClass()); 


System.arrayCopy(elements, © , a, 0 , size); 
if (a.length > size) 
a[size] = null ; 


return a; 


如 果 编 译 ArrayList » 该 方法 就 会 产生 这 1k 
ArrayList.java: 305 : warning: [unchecked] unchecked cast 


found : Object[], required: T[] 


return 
(T[]) Arrays.copyOf(elements, size, a.getClass()); 


A 


将 Suppresswarnings 注解 放 在 return 语句 中 是 非法 的 ， 
因为 它 不 是 一 个 生命 [JLS，9.7]。 你 可 以 试 着 将 注解 
放 在 整个 方法 上 ， 但 是 在 实践 中 干 万 不 要 这 人 么 做 ， 
ae ee 返回 值 ， 并 注解 其 

H 


// Adding local variable to reduce scope of @SuppressWarnings 











public <T> T[] toArray(T[] a) { 


if (a.length < size) { 


// This cast is correct because the array we're creating 





// is of the same type as the one passed in, which is T[]. 
@SuppressWarnings ( "unchecked" ) T[] result = 
(T[]) Arrays.copyoOf(elements, size, a.getClass()); 
return result; 
} 
System.arrayCopy(elements, © , a, © , size); 


if (a.length > size) 


a[size] = null ; 
return a; 


} 


这 个 方法 可 以 正确 地 编译 ， 茜 止 非 受 检 和 警告 的 范围 也 
减 到 了 最 小 。 


每 当 使 用 SuppressWarnings("unchecked") 注 解 时 ， 都 要 添加 一 条 注释 ， 
说 明 为 什么 这 么 做 是 安全 的 “。 这 样 可 以 帮助 其 他 人 理解 代码 ， 
更 重要 的 是 ， 可 以 尽量 减少 其 他 人 修改 代码 后 导致 计 
算 不 安全 的 概率 。 如 果 你 觉得 这 种 注释 很 难 编写 ， 整 
Ge ere een te 


总 而 言 之 ， 非 受 检 和 警告 很 重要 ， 不 要 忽略 它们 。 每 一 
条 警告 都 表示 可 能 在 运行 时 抛 出 czasscastException FF: 
常 。 要 尽 最 大 的 努力 消除 这 些 警 告 。 如 采 无 法 消除 
非 受 检 警告 ， 同 时 可 以 证 明 引 起 警告 的 代码 是 类 型 安 
全 的 ， 就 可 以 在 尽 可 能 小 的 范围 中 ， 用 

@SuppressWarnings ("unchecked") 注解 禁止 该 警告 o 要 用 注 


释 把 禁止 该 和 警告 的 原因 记录 下 来 。 


第 25 条 : 列表 优先 于 数组 


数组 与 泛 型 相 比 ， 有 两 个 重要 的 不 同 点 。 首 先 ， 数 组 
是 协 变 的 〈covariant) 。 这 个 词 听 起 来 有 点 吓人 人， 其 
实 只 是 表示 如 果 sub 为 super 的 子 类 型 ， 那 么 数组 类 
型 sub 就 是 super[] 的 子 类 型 。 相 反 ， 泛 型 则 是 不 
可 变 的 (invariant) : 对 于 任意 两 个 不 同 的 类 型 

Type1 和 Type2 > List<Type1> 既 不 是 List<Type2> 的 子 
类 型 ， 也 不 是 uist<rypez> 的 超 类 型 JLS，4.10:; 
Naftalin07，2.5]。 你 可 能 认为 ， 这 意味 着 泛 型 是 有 缺 
陷 的 ， 但 实际 上 可 以 说 数组 才 是 有 缺陷 的 。 


下 面 的 代码 片段 是 合法 的 : 



































// Fails at runtime! 
Object[] objectArray = new Long[ 1 ]; 


objectArray[ © ] = "I don't fit in" ; 
// Throws ArrayStoreException 


但 下 面 这 段 代码 则 不 合法 ; 
// Won't compile! 
List<Object> ol = new ArrayList<Object>(); 
// Incompatible types 


ol.add( "I don't fit in" ); 


这 其 中 无 论 哪 种 方法 ， 都 不 能 将 String 放 进 Long 容 
器 中 ， 但 是 利用 数组 ， 你 会 在 运行 时 发 现 所 犯 的 错 
tes 利用 列表 ， 则 可 以 在 编译 时 发 现 错误 。 我 们 当然 
硕 望 在 编译 时 发 现 错误 了 。 


数组 与 泛 型 之 间 的 第 二 大 区 别 在 于 ， 数 组 是 具体 化 的 
(reified) [JLS，4.7]。 因 此 数组 会 在 运行 时 才 知 道 
并 检查 它们 的 元 素 类 型 约束 。 如 上 所 述 ， 如 果 企 图 将 
string 保存 到 tong 数组 中 ， 束 会 得 到 一 个 
ArrayStoreException 异常 。 相 比 之 下 ， 泛 型 则 是 通过 PR 
除 (erasure) ULS，4.6] 来 实现 的 。 因 此 泛 型 只 在 编 
译 时 强化 它们 的 类 型 信息 ， 并 在 运行 时 丢弃 CGA 擦 
R) 它们 的 元 素 类 型 信息 。 擦 除 就 是 使 泛 型 可 以 与 
没有 使 用 泛 型 的 代码 随意 进行 互 用 〈 见 第 23 条 ) 。 


由 于 上 述 这 些 根本 的 区 别 ， 因 此 数组 和 泛 型 不 能 很 好 
地 混合 使 用 。 例 如 ， 创 建 泛 型 、 参 数 化 类 型 或 者 类 型 
参数 的 数组 是 非法 的 。 这 些 数 组 创建 表达 式 没有 一 个 
是 合法 的 : new List<E>[] 、 new List<String>[] 和 new 
Et) 。 这 些 在 编译 是 都 会 导致 一 个 generic array 
creation 〈 泛 型 数组 创建 ) 错误 。 


为 什么 创建 泛 型 数组 是 非法 的 ? 因为 它 不 是 类 型 安全 
的 。 要 是 它 合法 ， 编 译 器 在 其 他 正确 的 程序 中 发 生 的 
转换 就 会 在 运行 时 失败 ’ 并 出 现下 ClassCastException 











异常 。 这 就 违背 了 泛 型 系统 提供 的 基本 保证 。 
为 了 更 具体 地 对 此 进行 说 明 ， 考 虑 以 下 代码 片段 : 


// Why generic array creation is illegal - won't compile 
List<String>[] stringLists = new ArrayList<String>[ 1 
1// (1) 
/ vy 


List<Integer> intList = Arrays.asList( 42 ); 
fF 2% 


Object[] objects = stringLists; 
// (3) 


objects[ © ] = intList; 
// (4) 


String s = stringLists[ © ].get( 0 
); // (5) 


5) 


我 们 假设 第 1 行 是 合法 的 ， 它 创建 了 一 个 泛 型 数组 。 
第 2 行 创建 并 初始 化 了 一 个 包含 单个 元 素 的 
List<Integer> o 第 3 行将 List<String> 数组 保存 到 一 个 
object 数组 变量 中 ， 这 是 合法 的 ， 因 为 数组 是 协 变 
的 。 第 4 行将 List<Integer> 保存 到 Object 数组 里 唯一 
的 元 素 中 ， 这 是 可 以 的 ， 因 为 泛 型 是 通过 探 除 实现 
的 : List<Integer> 实例 的 运行 时 类 型 只 是 List ， 
List<string>[] 实例 的 运行 时 类 型 则 是 ist ， 因 此 
这 种 安排 不 会 产生 ArrayStoreException 异常 。 但 现在 我 
们 有 麻烦 了 。 我 们 将 一 个 List<Integer> 实例 保存 到 了 
原本 声明 只 包含 List<string> 实例 的 数组 中 。 在 第 5 行 
中 ， 我 们 从 这 个 数组 里 唯一 的 列表 中 获取 了 唯一 的 元 
素 。 编 译 器 自动 地 将 获取 到 的 元 素 转换 成 string ， 
但 它 是 一 个 integr ， 因 此 ， 我 们 在 运行 时 得 到 了 一 
个 ClassCastExcption 异常 。 为 了 防止 出 现 这 种 情况 ， 
《创建 泛 型 数组 的 ) 第 1 行 产 生 了 一 个 编译 时 错误 。 


从 技术 的 角度 来 说 ， 想 E 、 List<E> 和 List<String> 
这 样 的 类 型 应 称 作 不 可 具体 化 的 (nonreifiable〉 类 型 
DJLS，4.7]。 直 观 地 说 ， 不 可 具体 化 的 (non- 
reifiable) 类 型 是 指 其 运行 时 表示 法 包含 的 信息 比 它 
的 编译 时 表示 法 包含 的 信息 更 少 的 类 型 。 唯 一 可 具体 








MOH) Creifiable) 参数 化 类 型 是 无 限制 的 通配符 类 
AJ, UD List<z?> 和 wap<?,?> ( 见 第 23 条 ) 。 虽 然 不 常 
用 ， 但 是 创建 无 限制 通配符 类 型 的 数组 是 合法 的 。 


禁止 创建 泛 型 数组 可 能 有 点 讨厌。 例如 ， 这 表明 泛 型 
一 般 不 可 能 返回 它 的 元 素 类 型 数组 (部 分 解决 方案 请 
见 第 29 条 ) 。 这 也 意味 着 在 结合 使 用 可 变 参数 
(varargs) 方法 〈 见 第 42 条 ) 和 泛 型 时 会 出 现 令 人 费 
解 的 警告 。 这 是 由 于 每 当 调 用 可 变 参 数 方法 时 ， 就 会 
创建 一 个 数组 来 存放 varargs 参数 。 如 果 这 个 数组 的 
元 素 类 型 时 不 是 可 具体 化 的 (reifiable 〉， 束 会 得 到 
一 条 警告 。 关 于 这 些 警 告 ， 除 了 把 它们 蔡 止 〈 见 第 24 
条 ) ， 并 且 避 免 在 API 中 混合 使 用 泛 型 与 可 变 参 数 之 
外 ， 别 无 他 法 。 


当 你 得 到 泛 型 数组 创建 错误 时 ， 最 好 的 解决 办 法 通 当 
是 优先 使 用 集合 类 型 ise ， 而 不 是 数组 类 型 E[] 
。 这 样 可 能 会 损失 一 些 性 能 或 者 人 简洁 性 ， 但 是 换 回 的 
却 是 更 高 的 类 型 安全 性 和 互 用 性 。 


例如 ， 假设 有 一 个 ( Collections.synchronizedList 返回 的 
那 种 ) 同步 列表 和 一 个 函数 〈 它 有 两 个 域 该 列表 的 元 
素 同类 型 的 参数 值 ， 并 返回 第 三 个 值 ) 。 现 在 假设 要 
编写 一 个 方法 reduce ， 并 使 用 函数 apply 来 处 理 这 个 
列表 。 假 设 列表 元 素 类 型 为 整数 ， 并 且 函 数 是 用 来 做 
两 个 整数 求 和 运算 ， reduce 方法 就 会 返回 列表 中 所 
有 值 的 总 和 。 如 果 函 数 是 用 来 做 两 个 整数 求 积 的 运 
算 ， 该 方法 就 会 返回 列表 中 值 的 乘积 。 如 果 列 表 包 含 
字符 串 ， 并 且 函 数 连 接 两 个 字符 串 ， 该 方法 就 会 返回 
一 个 字符 串 ， 它 按 顺序 包含 了 列表 中 的 所 有 字符 串 。 
除了 列表 和 函数 之 外 ， reduce 方法 还 采用 初始 值 进 
行 减法 运算 ， 列 表 为 空 时 会 返回 这 个 初始 值 。〔 初 始 
值 一 般 为 函数 的 识别 元 素 ， 加 法 为 0， 乘 法 为 1， 字 符 
串 连 接 时 是 "。) 以 下 是 没有 泛 型 时 的 代码 ? 


// Reduction without generics, and with concurrency flaw! 














static Object reduce 
(List list, Function f, Object initVal) { 


synchronized (list) { 
Object result = initVal; 
for (Object o : list) 
result = f.apply(result, 0); 


return result; 


interface Function { 


Object apply (Object argi, Object arg2) ; 





假设 你 现在 已 经 读 过 第 67 条 ， 它 告诉 你 不 要 从 同步 区 
域 中 调用 “外 来 的 (alien) 方法 >”。 因 此 ， 在 持 有 锁 的 

时 候 修 改 reduce 方法 来 复制 列表 中 内 容 ， 也 可 以 让 

你 在 备份 上 执行 减法 。Java 1.5 发 行 版 本 之 前 ， 要 这 

List 的 toarray 方法 〈 它 在 内 部 锁定 
列表 ) : 


// Reduction without generics or concurrency flaw 








static Object reduce 
(List list, Function f, Object initVal) { 


Object[] snapshot = list.toArray(); 
// Locks list internally 


Object result = initVal; 
for (E e : snapshot) 
result = f.apply(result, e); 


return result; 


WREE OR SE KS BAZ A 
We ALARM. DAR aE Function 接口 的 泛 型 版 : 


interface Function <T> { 


T apply (T argi, T arg2) ; 





下 面 是 一 种 天 真 的 答 试 ， 试 图 将 泛 型 应 用 到 修改 过 的 
reduce 方法 。 这 是 一 个 泛 型 方法 (generic method, 
见 第 27 条 ) 。 如 采 你 不 理解 这 条 声明 ， 也 不 必 担 心 。 
对 于 这 个 条 目 来 说 ， 应 该 把 注意 力 集中 在 方法 体 上 : 





// Naive generic version of reduction - won't compile! 


static <E> E reduce 
(List<E> list, Function<E> f, E initVal) { 


E[] snapshot = list.toArray(); // Locks list 
E result = initVal; 
for (E e : snapshot) 
result = f.apply(result, e); 


return result; 


WR SEK SIE, MAAA) F EAR A: 
Reduce.java: 12 : incompativle types 
found : Object[], required: E[] 


E[] snapshot = list.toArray(); // Locks list 


A 


你 会 说 ， 这 没什么 大 不 了 的 ， 我 会 将 object 数组 转 
换 成 一 个 e 数组 : 


E[] snapshot = (E[]) list.toArray(); 





它 是 消除 了 那 条 错误 ， 但 是 现在 得 到 了 一 条 警告 : 


Reduce.java: 12 : warning: [unchecked] unchecked cast 


found : Object[], required:L E[] 


E[] snapshot = (E[]) list.toArray(); 
// Locks list 





编译 器 告诉 你 ， 它 无 法 在 运行 时 检查 转换 的 安全 性 ， 
因为 它 在 运行 时 还 不 知道 上 是 什么 一 一 记 住 ， 元 素 
类 型 信息 会 在 运行 时 从 泛 型 中 被 擦 除 。 这 上段 程序 可 以 
运行 吗 ? 结果 表明 ， 它 可 以 运行 ,但 是 不 安全 。 通 过 
微小 的 修改 ， 就 可 以 让 它 在 没有 包含 显 式 转换 的 行 上 
抛 出 ClassCastException 异常 。 Snapshot 的 编译 时 类 型 
AY et) ， 它 可 以 为 stringi] 、 Integer[] 或 者 任何 其 
他 种 类 的 数组 。 运 行 时 类 型 为 objecti) ， 这 是 很 危险 
的 。 不 可 具体 化 的 类 型 的 数组 转换 只 能 在 特殊 情况 下 
使 用 〈 见 第 26 条 ) 。 


那么 应 该 做 些 什么 呢 ? 用 列表 代 蔡 数组 。 下 面 的 
reduce 方法 编译 时 就 没有 任何 错误 或 者 警告 : 


// List-based generic reduction 














static <E> E reduce 
(List<E> list, Funciton<E> f, E initVal) { 


List<E> snapshot; 
synchronized (list) { 
snapshot = new ArrayList<E>(list); 
} 
E result = initVal; 
for (E e : snapshot) 
result = f.apply(result, e); 


return result; 


这 个 版 本 的 代码 比 数组 版 的 代码 稍微 见长 一 点 ， 但 是 
可 以 确 定 在 运行 时 不 会 得 到 ClassCastException 异常 ’ 
为 此 也 值 了 。 


总 而 言 之 ， 数 组 和 泛 型 有 着 非常 不 同 的 类 型 规则 。 数 
组 是 协 变 并 且 可 以 具体 化 的 ， 反 省 是 不 可 变 的 且 可 以 











被 探 除 的 。 因 此 ， 数 组 提供 了 运行 时 的 类 型 安全 ， 但 
是 没有 编译 时 的 类 型 安全 ， 反 之 ， 对 于 泛 型 也 一 样 。 
一 般 来 说 ， 数 组 和 泛 型 不 能 很 好 地 混合 使 用 。 如 果 你 
发 现 目 己 将 它们 混合 起 来 使 用 ， 并 且 得 到 了 编译 时 的 
i E A EAR 
组 。 


第 26 条 : 优先 考虑 泛 型 


一 般 来 说 ， 将 集合 声明 参数 化 ， 以 及 使 用 JDK 所 所 
供 的 泛 型 和 泛 型 方法 ， 这 些 都 不 太 困 难 。 编 写 上 自己 的 
泛 型 会 比较 困难 一 些 ， 但 是 值得 花 些 时 间 学 习 如 何 编 


do 




















写 。 
考虑 第 6 条 中 这 个 简单 的 堆栈 实现 : 
// Object- 


based collection - a prime candidate for generics 
public class Stack { 

private Object[] elements; 

private int [size = 0 | 


private static final int 
DEFAULT_INITIAL_CAPACITY = 16 ; 


public Stack () { 


elements = new Object[DEFAULT_INITIAL_CAPACITY]; 


public void push (Object e) { 
ensureCapacity(); 


elements[size++] = e; 


public Object pop () { 


if (size == 0 ) 
throw new EmptyStackException(); 
Object result = elements[--size]; 


elements[size] = null ; 
// Eliminate obsolete reference 


return result; 


public boolean isEmpty () { 


return size == 0; 


private void ensureCapacity () { 
if (elements.length == size) 


elements = Arrays.copyOf(elements, 2 
* size + 1); 


} 


这 个 类 是 泛 型 化 Cgenerification) 的 主要 备 选 对 
象 ， 换 名 话说 ， 可 以 适当 地 强化 这 个 类 类 利用 泛 
型 。 根 据 实际 情况 来 看 ， 必 须 转换 从 堆栈 里 弹出 
的 对 象 ， 以 及 可 能 在 运行 时 失败 的 那些 转换 。 将 
类 泛 型 化 的 第 一 个 步 又 是 给 它 的 声明 添加 一 个 或 
者 多 个 类 型 参数 。 在 这 个 例子 中 有 一 个 类 型 参 

数 ， 它 表示 堆栈 的 元 素 类 型 ， 这 个 参数 的 名 称 通 
mA E ( 见 第 4 条 ) 。 


下 一 步 是 用 相应 的 类 型 参数 答 换 所 有 的 object 
类 型 ， 然 后 试 着 编译 最 终 的 程序 : 


// Initial attempt to generify Stack = won't compile 





public class Stack < E> { 
private E[] elements; 


private int size= 0; 


private static final int 
DEFAULT_INITIAL_CAPACITY = 16 ; 


public Stack () { 


elements = new E[DEFAULT_INITIAL_CAPACITY]; 


public void push (Ee) { 
ensureCapacity(); 


elements[size++] = e; 


public E pop () { 
if (size == 0 ) 
throw new EmptyStackException(); 
E result = elements[--size]; 


elements[size] = null ; 
// Eliminate obsolete reference 


return result; 


// no changes in isEmpty or ensureCapacity 


， 你 将 至 少 得 到 一 个 错误 或 警告 ， 这 
SHRI. 幸运 的 是 ， 这 个 类 只 产生 一 
fitz, UF: 


Stack.java: 8 : generic array creation 


elements = new 
E[DEFAULT_INITIAL_CAPACITY ] ; 


A 


如 第 25 条 中 所 述 ， 你 不 能 创建 不 可 具体 化 
的 〈non-reifiable) 类 型 的 数组 ， 如 E o 
当 编 写 用 数组 文 持 的 泛 型 时 ， 都 会 出 现 这 个 
问题 。 解 决 这 个 问题 有 两 种 方法 。 第 一 种 ， 
直接 绕 过 创建 泛 型 数组 的 禁令 : 创建 一 个 
object 的 数组 ， 并 将 它 转 换 为 泛 型 数组 类 
型 。 现 在 错误 是 消除 了 ， 但 是 编译 右 会 产生 
一 条 警告 。 这 种 用 法 是 合法 的 ， 但 (整体 上 
mE) 不 是 类 型 安全 的 : 


Stack.java: 8 : [unchecked] unchecked cast 
found : Object[], required: E[] 


elements = (E[]) new 
Object [DEFAULT_INITIAL_CAPACITY]; 


A 


编译 器 不 可 能 证 明 你 的 程序 是 类 型 安全 的 ， 
但 是 你 可 以 证 明 。 你 自己 必须 确保 未 受 检 的 
转换 不 会 危及 到 程序 的 类 型 安全 性 。 相 关 的 
数组 CHH elements 变量 ) 保存 在 一 个 私有 的 
域 中 ， 永 远 不 会 被 返回 到 客户 端 ， 或 者 传递 
给 任何 其 他 方法 。 这 个 数组 中 保存 的 唯一 元 
素 ， 是 传 给 push 方法 的 那些 元 素 ， 它 们 的 
ae ee 
Ge 


一 旦 你 证 明了 未 受 检 的 转换 是 安全 的 ， 束 要 
在 尽 可 能 小 的 范围 中 茶 止 警告 〈 见 第 24 

条 ) 。 在 这 种 情况 下 ， 构 造 嚣 只 包含 未 受 检 
的 数组 创建 ， 因 此 可 以 在 整个 构造 器 中 禁止 
这 条 警告。 通过 增加 一 条 注解 来 完成 禁止 ， 
stack 能 够 正确 无 误 地 进行 编译 ， 你 就 可 以 
使 用 它 了 ， 无 需 显 式 的 转化 ， 也 无 需 担 心 会 


Ay, 
出 现 ClassCastException 异常 : 








™~N 


/ 





The elements array will contain only E instances from push(E). 


// This is sufficient to ensure type safety, but the runtime 


// type of the array won't be E[]; it will always be Object[]! 
@SuppressWarnings ( "unchecked" ) 
public Stack () { 


elements = (E[]) new 
Object [DEFAULT_INITIAL_CAPACITY]; 


} 


消除 stack 中 泛 型 数组 创建 错误 的 第 二 种 方 
法 是 ， 将 elements 域 的 类 型 从 E[] 改 为 
Object[] oœ 这 么 做 会 得 到 一 条 不 同 的 错误 : 


Stack.java: 19 : incompatible types 
found : Object, required: E 
E result = elements[--size]; 


A 


REAA ASIN TUR A komeen 
换 成 E ， 可 以 将 这 条 错误 变 成 一 条 警告 


Stack.java: 19 
: warning: [unchecked] unchecked cast 


found : Object, required: E 
E result = elements[--size]; 


A 


HF e E ADIR LERI Cnon- 
reifiable》 类 型 ， 编 译 器 无 法 在 运行 时 检验 
转换 。 i 
安全 的 ， 因 此 可 以 禁止 该 警告 。 根 据 第 24 
条 的 建议 ， 我 们 只 要 在 包含 未 受 检 和 转换 的 任 
务 上 禁止 警告 ， 而 不 是 在 整个 pop 方法 上 就 
可 以 了 ， 如 下 : 


// Appropriate suppression of unchecked warning 





public E pop () { 


if (size == 0 ) 


throw new EmptyStackException(); 


// push requires elements to be of type E, so cast is correct 


@SuppressWarnings ( "unchecked" 
) E result = 


(E) elements[--size]; 


elements[size] = null ; 
// Eliminate obsolete reference 


return result; 


具体 选择 这 两 种 方法 中 的 哪 一 种 来 处 理 泛 型 
数组 创建 错误 ， 这 要 看 个 人 的 偏好 了 。 所 有 
其 他 的 东西 都 一 样 ， 但 是 禁止 数组 类 型 的 未 
受 检 和 转换 比 禁 止 标量 类 型 (scalar type) 的 

更 加 危险 ， 所 以 建议 采用 第 二 种 方案 。 但 是 
在 比 Stack 更 实际 的 泛 型 类 中 ， 或 许多 代码 
会 有 多 个 地 方 需要 从 数组 中 读 取 元 素 ， 因 此 
选择 第 二 种 方案 需要 多 次 转换 成 ， 而 不 
是 只 转换 成 er] ， 这 也 是 第 一 种 方案 之 所 以 
更 常用 的 原因 [Naftalin07，6.7]。 


下 面 的 程序 示范 了 泛 型 stack 类 的 使 用 。 程 
序 以 相反 的 顺序 打印 出 它 的 命令 行 参数 ， 并 
转换 成 大 写字 母 。 如 果 要 从 堆栈 中 弹出 的 元 
过 上 调用 String 的 toUpperCase 方法 ， 并 不 
需要 显 式 的 转换 ， 并 且 会 确保 自动 生成 的 转 
换 会 成 功 : 


// Little program to exercise our generic Stack 

















public static void mai (String[] args) 
Stack<String> stack = new Stack<String> 


for (String arg : args) 


stack.push(args); 
while (!stack.isEmpty()) 


System.out.println(stack.pop.toUpperCase()); 


看 来 上 述 的 示例 与 第 25 条 相 矛 盾 了 ， 第 25 
条 鼓励 优先 使 用 列表 而 非 数 组 。 实 际 上 并 不 
可 能 总 是 或 者 总 想 在 泛 型 中 使 用 列表 。Java 
并 不 是 生来 就 文 持 列 表 ， 因 此 有 些 泛 型 如 
ArrayList 则 必须 在 数组 上 实现 。 为 了 提升 
性 能 ， 其 他 泛 型 如 nasnwap 也 在 数组 上 实 
现 。 


绝 大 多 数 泛 型 就 像 我 们 的 stack 示例 一 样 ， 
因为 它们 的 类 型 参数 没有 限制 : 你 可 以 创建 
Stack<Object> 、 Stack<int[]> 、 
Stack<List<String>> 5 或 者 任何 其 他 对 象 引用 
类 型 的 stack 。 注 意 不 能 创建 基本 类 型 的 
Stack : 企图 创建 Stack<int> 或 者 
Stack<double> 会 产生 一 个 编译 时 错误 。 这 是 
Java 泛 型 系统 根本 的 局 限 性 。 你 可 以 通过 使 
用 包装 类 型 (boxed primitive type) 来 避 开 
这 条 限制 〈 见 第 49 条 ) 。 


有 一 些 泛 型 限制 了 可 允许 的 类 型 参数 值 。 例 
如 ， 考虑 java.util.concurrent.DelayQueue ， 其 


声明 如 下 : 


class DelayQueue < E extends Delayed > 
implements BlockingQueue < E > ; 





类 型 参数 列表 ( <E extends Delayed> ) 要 求实 
际 的 类 型 参数 e 必须 是 
java.util.concurrent.Delayed 的 一 个 子 类 型 。 它 
人 允许 DelayedQueue 实现 及 其 客户 端 在 
DelayedQueue 元 素 上 利用 Delayed 方法 ， 无 需 


显 式 的 转换 ， 也 没有 出 现 ClassCastException 
的 风险 。 类 型 参数 E 被 称 作 有 限制 的 类 型 
参数 (bounded type parameter) 。 注 意 ， 子 
类 型 关系 确定 了 ， 每 个 类 型 都 是 它 自身 的 子 
类 型 [JLS，4.10]， 因 此 创建 


DelayedQueue<Delayed> fe Bie 的 o 


总 而 言 之 ， 使 用 泛 型 比 使 用 需要 在 客户 端 代 
人 码 中 进行 转换 的 类 型 来 得 更 加 安全 ， 也 更 加 
容易 。 在 设计 新 类 型 的 时 候 ， 要 确保 它们 不 
需要 这 种 转换 就 可 以 使 用 。 这 通常 意味 着 要 
把 类 做 成 是 泛 型 的 。 只 要 时 间 人 允许 ， 束 把 现 
有 的 类 型 都 泛 型 化 。 这 对 于 这 些 类 型 的 新 用 
户 来 说 会 变 得 更 加 qingso9ng， 又 不 会 破坏 现 
有 的 客户 端 〈 见 第 23 2) 。 





第 27 条 : MTs wiz TIE 


就 如 类 可 以 从 泛 型 中 收益 一 般 ， 方 法 也 一 样 。 静 态 工具 方法 尤其 适合 于 
i FL. Collections 中 的 所 有 “算法 ”方法 (例如 binarySearch 和 sort ) 
都 泛 型 化 了 。 
编写 泛 型 方法 与 编写 泛 型 类 相 类 似 。 例 如 下 面 这 个 方法 ， 它 返回 两 个 集 
合 的 联合 : 
// Uses raw types - unacceptable! (Item 23) 
public static Set union (Set s1, Set s2) { 
Set result = new HashSet(s1); 
result.addAll(s2); 


return result; 


这 个 方法 可 以 编译 ， 但 是 有 两 条 警告 : 
Union.java: 5 : warning: [unchecked] call to 
Hashset (Collection<? extends E>) as a member of raw type HashSet 
Set result = new HashSet(s1); 
A 
Union.java: 6 : warning: [unchecked] call to 
addAll (Collection<? extends E>) as a member of raw type Set 


result. addAll (s2) ; 


A 





为 了 修正 这 些 警告 ， 使 方法 编程 是 类 型 安全 的 ， 要 将 方法 声明 修改 为 声 
明 一 个 类 型 参数 ， 表 示 这 三 个 集合 的 元 素 类 型 〈 两 个 参数 和 一 个 返回 

值 ) ， 并 在 方法 中 使 用 类 型 参数 。 声 明 类 型 参数 的 类 型 参数 列表 ， 处 在 
方法 的 修饰 符 及 其 返回 类 型 之 间 。 在 这 个 示例 中 ， 类 型 参数 列表 为 <p 
， 返 回 类 型 为 sec 。 类 型 参数 的 命名 管理 与 泛 型 方法 以 及 泛 型 的 相 
同 ( 见 第 26 条 和 第 44 条 ) : 





// Generic method 

public static <E> Set<E> union (Set<E> si, Set<E> s2) { 
Set<E> result = new HashSet<E>(s1); 
result.addAll(s2); 


return result; 


FORTARRE AWA. EIA RS. MEAT E i EIN AS 
会 产生 任何 警告 ， 并 提供 了 类 型 安全 性 ， 也 更 容易 使 用 。 以 下 是 一 个 知 
性 该 方法 的 简单 程序 。 程 序 中 不 包含 转换 ， 编 译 时 不 会 有 错误 或 者 警 





a 
A 


// Simple program to exercise generic method 
public static void main (String[] args) { 


Set<String> guys = new HashSet<String>( 


Arrays.asList( "Tom" , "Dick" , "Harry" )); 
Set<String> stooges = new HashSet<String>( 
Arrays.asList( "Larry" , "Moe" , "Curly" )); 


Set<String> aflCio = union(guys, stooges); 


System.out.println(aflCio); 


运行 这 段 程序 时 ， 会 打印 出 [Moe, Harry, Tom, Curly, Larry, Dick] oœ 元 素 的 
顺序 是 依赖 于 实现 的 。 


union 方法 的 局 限 性 在 于 ， 三 个 集合 的 类 型 (两 个 输入 参数 和 一 个 返回 
值 ) 必须 全 部 相同 。 利 用 有 限制 的 通配符 类 型 (bounded wildcard 
type) ， 可 以 使 这 个 方法 变 得 更 加 灵活 《〈 见 第 28 条 ) 。 


泛 型 方法 的 一 个 显著 特性 是 ， 无 需 明 确 指 定 类 型 参数 的 值 ， 不 像 调用 泛 
型 构造 器 的 时 候 是 必须 指定 的 。 编 译 器 通过 检查 方法 参数 的 类 型 来 计算 
类 型 参数 的 值 。 对 于 上 述 的 程序 而 言 ， 编 译 器 发 现 union 的 两 个 参数 都 
是 Set<String> 类 型 ， 因此 知道 类 型 参数 E 必须 为 String o IX WER 
作 类 型 推导 (type inference). 


如 第 1 条 所 述 ， 可 以 利用 泛 型 方法 调用 所 提供 的 类 型 推导 ， 使 创建 参数 
化 类 型 实例 的 过 程 变 得 更 加 轻松 。 提 醒 一 下 : 在 调用 泛 型 构造 占 的 时 
候 ， 要 明确 传递 类 型 参数 的 值 可 能 有 点 麻烦 。 类 型 参数 出 现在 了 变量 声 
明 的 左右 两 边 ， 显 得 有 些 元 余 : 


// Parameterizedtype instance creation with constructor 
Map<String, List<String>> anagrams = 


new HashMap<String, List<String>>(); 


为 了 消除 这 种 元 余 ， 可 以 编写 一 个 泛 型 静态 工厂 方法 (generic static 
factory method) ， 与 想 要 使 用 的 每 个 构造 右 相 对 应 。 例 如 ， 下 面 是 一 个 
与 无 参 的 hashmap 构造 器 相对 应 的 泛 型 静态 工厂 方法 : 


// Generic static factory method 
public static <K, V> HashMap<K, V> newHashMap () { 


return new HashMap<K, V>(); 


通过 这 个 泛 型 静态 工厂 方法 ， 可 以 用 下 面 这 上 段 简洁 的 代码 来 取代 上 面 那 
个 重复 的 声明 : 


// Parameterizedtype instance creation with static factory 


Map<String, List<String>> anagrams = newHashMap(); 


在 泛 型 上 调用 构造 器 时 ， 如 果 语 言 所 有 的 类 型 推导 与 调用 泛 型 方法 时 所 
做 的 相同 ， 那 残 好 了 。 将 来 的 条 一 天 也 许可 以 实现 这 一 点 ， 但 截至 Java 
1.6 KATHE 


相关 的 模式 是 泛 型 单 例 工厂 (generic singleton factory) 。 有 时 ， 会 需要 
创建 不 可 变 但 又 适合 于 许多 不 同类 型 的 对 象 。 由 于 泛 型 是 通过 探 除 〈 见 
第 25 条 ) 实现 的 ， 可 以 给 所 有 必要 的 类 型 参数 使 用 单个 对 象 ， 但 是 需要 
编写 一 个 静态 工厂 方法 ， 重 复 地 给 每 个 必要 的 类 型 参数 分 发 对 象 啊 。 这 
种 模式 最 常用 于 函数 对 象 ( 见 第 21 条 ) ’ 如 Collections.reverseOrder +5 但 
也 适用 于 像 Collections.emptySet 这 样 的 集合 。 


假设 有 一 个 接口 ， 描 述 了 一 个 方法 ， 该 方法 接受 和 返回 某 个 类 型 + 的 








值 : 


public interface UnaryFunction < T> { 


T apply (T arg) ; 


现在 假设 要 提供 一 个 恒 等 函数 (identity function) 。 如 果 在 每 次 需要 的 
时 候 都 重新 创建 一 个 ， 这 样 会 很 浪费 ， 因 为 它 是 无 状态 的 
(stateless) 。 如 果 泛 型 被 具体 化 了 ， 每 个 关 型 都 需 要 一 个 恒 等 函 数 ， 
但 是 它们 被 擦 除 以 后 ， 就 只 需要 个 泛 型 单 例 。 请 看 以 下 示例 : 








// Generic singleton factory pattern 
private static UnaryFunction<Object> IDENTITY_FUNCTION = 
new UnaryFunction<Object>() { 


public Object apply (Object arg) { return arg; } 


// IDENTITY_FUNCTION is stateless and its type parameter is 

// unbounded so it's safe to share one instance across all types. 
@SuppressWarnings ( "unchecked" ) 

public static <T> UnaryFunction<T> identityFunction () { 


return (UnaryFunction<T>) IDENTITY_FUNCTION; 





IDENTITY_FUNCTION 转换 成 UnaryFunction<T> ) 产生 了 

a ALA UnaryFunction<0bject> 对 于 每 个 面 .来 说 并 非 都 是 

unaryFunction<T> 。 但 是 恒 等 函 数 很 特殊 : 它 返 BA Me ot So, 因此 
我 们 知道 无 论 T 的 值 是 什么 ， 用 它 作 为 unaryFunction<r> 都 是 类 型 安全 
的 。 因 此 ， 我 们 可 以 放心 地 禁止 由 这 个 转换 所 产生 的 未 受 检 转 换 警 告 

一 旦 茶 止 ， 代 码 在 编译 时 就 不 会 出 现任 何 错误 或 者 警告 。 


UPET PFE Re, A FAY 型 单 例 作为 UnaryFunction<String> 和 
UnaryFunction<Number> o 像 往 常 一 样 ， 它 不 包含 转换 ， 编译 时 没有 出 现 错 


误 或 者 警告: 








// Sample program to exercise generic singleton 

public static void main (String[] args) { 
String[] strings = { "jute" , "hemp" , "nylon" }; 
UnaryFunction<String> sameString = identityFunction(); 
for (String s : strings) 


System.out.println(sameString.apply(s)); 


Number[] numbers = { 1, 2.0, 3L }; 
UnaryFunction<Number> sameNumber = identityFunction(); 
for (Number n : numbers) 


System.out.println(sameNumber .apply(n)); 


虽然 相对 少见 ， 但 是 通过 某 个 包含 该 类 型 参数 本 身 的 表达 式 来 限制 类 型 
参数 是 允许 的 。 这 就 是 递归 类 型 限制 (recursive type bound ) 。 递 归 
类 型 限制 最 普遍 的 用 途 与 Comparable 接口 有 关 ， 它 定 义 类 型 的 目 然 顺 
FF: 


public interface Comparable < T> { 





int compareTo (T o) ; 


类 型 参数 1 定义 的 类 型 ， 可 以 与 实现 comparavle<r> 的 类 型 的 元 素 进行 上 
较 。 实 际 上 ， 几 乎 所 有 的 类 型 都 只 能 与 它们 目 且 的 类 型 的 元 素 相 比较 。 
因此 ， 例如 String 实现 Comparable<String>  ， Integer 实现 
Comparable<Integer>  ， 等 等 。 

有 许多 方法 都 带 有 一 | 实现 Comparable 接口 的 元 素 列 表 ， 为 了 对 列表 进 
行 排 序 ， 并 在 其 中 进行 搜索 ， 计 算 它 的 最 小 值 或 者 最 大 值 ， 等 等 。 要 完 
成 这 其 中 的 任何 一 项 工作 ， 要 求 列表 中 的 每 个 元 素 都 能 够 与 列表 中 的 每 
个 其 他 元 素 相 比较 ， 换 名 话说， 列表 的 元 素 可 以 互相 比较 (mutually 
comparable) 。 下 面 是 如 何 表 达 这 种 约束 条 件 的 一 个 示例 : 


// Using a recursive type bound to express mutual comparability 








public static <T extends Comparable<T>> T max (List<T> list) Tanay 


类 型 限制 <T extends Comparable<T>> 可 以 读 作 “针对 可 以 与 自身 进行 比较 的 
每 个 类 型 + ”， 这 与 互 比 性 的 概念 或 多 或 少 有 些 一 致 ， 








下 面 的 方法 束 带 有 上 述 声 明 。 它 根据 元 素 的 目 然 顺 厅 计 算 列表 的 最 大 
值 ， 编 译 时 没有 出 现任 何 错误 或 者 警告 : 
// Returns the maximum value in a list - uses recursive type bound 


public static <T extends Comparable<T>> T max (List<T> list) { 
Iterator<T> i = list.iterator(); 
T result = i.next(); 
while (i.hasNext()) { 
T t = i.next(); 
if (t.compareTo(result) > 0 ) 
result = t; 
} 
return result; 


} 


递归 类 型 限制 可 能 比 这 个 要 复杂 得 多 ， 但 羊 运 的 是 ， 这 种 情况 并 不 经 各 
发 生 。 如 果 你 理解 了 这 种 习惯 用 法 及 其 通配符 变量 〈 见 第 28 条 ) ， 就 能 
够 处 理 在 实践 中 遇 到 的 许多 递归 类 型 限制 了 。 

忆 而 言 之 ， 泛 型 方法 就 像 泛 型 一 样 ， 使 用 起 来 比 要 求 客 刻 站 转换 输入 参 
数 并 返回 值 的 方法 来 得 更 加 安全 ， 也 更 加 容易 。 就 像 类 型 一 样 ， 你 应 该 
确保 新 方法 可 以 不 用 转换 束 能 使 用 ， 这 通常 意味 着 要 将 它们 泛 型 化 。 并 
且 就 像 类 型 一 样 ， 还 应 该 将 现 有 的 方法 泛 型 化 ， 使 新 用 户 使 用 起 来 更 加 
轻松 ， 且 不 会 破坏 现 有 的 客户 端 〈 见 第 23 条 ) 。 


第 28 条 : 利用 有 限 通 配 符 来 提升 API 
的 灵活 性 


如 第 25 条 所 述 ， 参 数 化 类 型 是 不 可 变 的 Cinvariant) 。 换 名 话说， 对 于 


任何 两 个 截然 不 同 的 Type 和 type2 IMG, List<typer> BLAZE 
List<Type2> 的 子 类 型 ， 也 不 是 它 的 超 类 型 。 虽然 List<String> 不 是 
List<Object> 的 子 类 型 ， 这 与 直 党 相悖 ， 但 是 实际 上 很 有 意义 。 你 可 以 
将 任何 对 象 放 进 一 个 List<object> 中 ， 却 只 能 将 字符 串 放 进 List<string> 


o 


AWIR, BRANT rier BEY oR TR PE BEL AS ay ARS EREE. GE S26 
条 中 的 堆栈 ， 下 面 就 是 它 的 公共 API; 


public class Stack < E> { 





public Stack () ; 
public void push (E e) ; 
public E pop () ; 


public boolean isEmpty () ; 


ABC RATA ETI ATE LEE PII RITR I HE 
中 。 这 是 第 一 次 尝试 ， 如 下 : 
// pushAll method without wildcard type - deficient! 
public void pushAll (Iterable<E> src) { 
for (Ee: src) 


push(e); 


这 个 方法 编译 时 正确 无 误 ， 但 并 非 尽 如 人 意 。 如 果 Iterable src 的 元 素 
类 型 与 堆栈 的 完全 匹配 ， 就 没有 问题 。 但 是 假如 有 一 个 stack<Number> ， 
并 且 调 用 了 push(intVal) 5 这 里 的 intVal 就 是 Integer 类 型 。 这 是 你 可 
以 的 ， 因为 Integer 是 Number 的 一 个 子 类 型 。 因此 从 逻辑 上 来 说 ， 下 面 
这 个 方法 应 该 也 可 以 : 

Stack<Number> numberStack = new Stack<Number>(); 

Iterable<Integer> integers = ...; 


numberStack.pushAll(integers); 


但 是 ， 如 果 尝 试 这 么 做 ， 就 会 得 到 下 面 的 错误 消息 ， 因 为 如 前 所 述 ， 参 
数 化 类 型 是 不 可 变 的 : 

StackTest.java: 7 : pushAll(Iterable<Number>) in Stack<Number> 

cannot be applied to (Iterable<Integer>) 


numberStack. pushAll (integers) ; 


A 





幸运 的 是 ， 有 一 种 解决 办 法 。Java 提 供 了 一 种 特殊 的 参数 化 类 型 ， 称 作 
有 限制 的 通配符 类 型 Cbounded wildcard type) ， 来 处 理 类 似 的 情况 。 
pushAll 的 输入 参数 类 型 不 应 该 为 * E 的 rterable 接口 ?， 而 应 该 为 上 
的 某 个 子 类 型 的 rterable 接口 "有 一 个 通配符 类 型 正 符合 此 意 : 
Iterable<? extends E> o (使 用 关键 字 extends 有 些 误导 : 回忆 一 下 第 26 
条 中 的 说 法 ， 确 定 了 子 类 型 (subtype) 后 ， 每 个 类 型 便 都 是 自身 的 子 
ee ee) eee 


// Wildcard type for parameter that serves as an E producer 








public void pushAll (Iterable<? extends E> src) { 
for (Ee: src) 


push(e); 


这 么 修改 了 以 后 ， 不 仅 stack 可 以 正确 无 误 地 编译 ， 没 有 通过 初始 的 
pusati 声明 进行 编译 的 客户 端 代码 也 一 样 可 以 。 因 为 stack 及 其 客户 
端正 确 无 误 地 进行 了 编译 ， 你 就 知道 一 切 都 是 类 型 安全 有 的 了 。 
现在 假设 想 要 编写 一 个 pusa 方法 ， 使 之 与 popAll 方法 相 呼应 。 
popAll ATV MOT ARASH RATAR, FRR CEE TO se as UB E HSE 
中 。 初 次 尝试 编写 的 _popAll 方法 可 能 像 下 面 这 样 : 

// popAll method without weildcard type - deficient! 

public void popAll (Collection<E> dst) { 

while (!isEmpty()) 


dst.add(pop()); 


} 





如 果 目 标 集合 的 元 素 类 型 与 堆栈 的 完全 匹配 ， 这 段 代码 编译 时 还 是 会 正 

确 无 误 ， 运 行 得 很 好 。 但 是 ， 也 并 不 意味 着 尽 如 人 意 。 假 设 你 有 一 个 
Stack<Number> 和 类 型 Object 的 变量 。 如 果 从 堆栈 中 弹出 一 个 元 素 ， 并 将 

i a 
We? 


Stack<Number> numberStack = new Stack<Number>(); 














Collection<Object> objects = ...; 


numberStack.popAll(objects); 


如 果 试 着 用 上 述 的 ppa 版 本 编译 这 段 客户 端 代码 ， 就 会 得 到 一 个 非 
第 类 似 于 第 一 次 用 pushAll 时 所 得 到 的 错误 : Collection<Object> 不 是 
Collection<Number> 的 子 类 型 。 kik, 通配符 类 型 同样 提供 了 一 种 解决 
办 法 。 popa 的 输入 参数 类 型 不 应 该 为 “* E 的 集合 ”"， 而 应 该 为 “* E 的 
某 种 超 类 的 集合 (这 里 的 超 类 是 确定 的 ， 因 此 e 是 它 自身 的 一 个 超 类 
型 [JLS， 4.10]) o 仍然 有 一 个 通配符 正 是 符合 此 意 : Collection<? super 
E> 。 让 我 们 修改 popAll 来 使 用 它 : 


// Wildcard type for parameter that serves as an E consumer 











public void popAll (Collection<? super E> dst) { 
while (!isEmpty()) 
dst.add(pop()); 


} 





做 了 这 个 变动 之 后 ， stack WIZE Pie RA A AY CIE AC HAE To 


结论 很 明显 。 为 了 获得 最 大 限度 的 灵活 性 ， 要 在 表示 生产 者 或 者 消费 者 
的 输入 参数 上 使 用 通配符 类 型 。 如 果 某 个 输入 参数 既是 生产 者 ， 有 事 
消费 者 ， 那 么 通配符 类 型 对 你 束 没 有 什么 好 处 了 : 因为 你 需要 的 是 严格 
的 类 型 匹配 ， 这 是 不 用 任何 通配符 而 得 到 的 。 


下 面 的 助 记 符 便于 让 你 记 住 要 使 用 哪 种 通配符 类 型 : 

















PECS 表示 producer-extends, consumer-super 。 


换 句 话说 ， 如 果 参 数 化 类 型 表示 一 个 T 生产 者 ， 束 是 用 <? extends T> ; 
如 果 它 表示 一 个 T 消费 者 ， 束 是 用 < super t> 。 在 我 们 的 stack 示例 
H, pushall 的 sro 参数 产生 e 实例 供 stack H, AE sre 相应 区 
类 型 为 Iterable<? extends E> 3 popAll 的 dst 参数 通过 Stack 消费 E s 
例 ， 因此 dst 相应 的 类 型 为 Collection<? super E> o PECS 这 个 助 记 符 突 蝇 
了 使 用 通配符 类 型 的 基本 原则 。Naftalin 和 Wadler 称 之 为 Get and Put 

Principle [Naftalin07, 2.4]。 


记 住 这 个 助 记 符 ， 我 们 下 面 来 看 一 些 之 前 的 条 目 中 提 到 过 的 方法 声明 。 
第 25 条 中 的 reduce 方法 就 有 这 条 声明 : 


static <E> E reduce (List<E>, list, Function<E> f, E initVal) 


虽然 列表 既 可 以 消费 也 可 以 产生 值 ， reduce 方法 还 是 只 用 它 的 list 2 
数 作 为 上 生产 者 (producer) ， 因 此 它 的 声明 就 应 该 使 用 一 个 extends 
E 的 通配符 类 型 。 参 数 表示 皆 可 以 消费 又 可 以 产生 e 实例 的 函数 ， 
因此 通配符 类 型 不 适合 它 。 得 到 的 方法 声明 如 下 : 


// Wildcard type for parameter that serves as an E producer 





static <E> reduce(List<? extends E> list, Function<E> f, 


E initVal) 





这 一 变化 实际 上 有 什么 区 别 吗 ? 事实 上 ， 的 确 有 区 别 。 假 设 你 有 一 个 
ES ’ 想 通 过 Function<Number> 把 它 简 化 。 它 不 能 通过 初始 声明 
进行 编译 ， 但 是 一 旦 添加 了 有 限制 的 通配符 类 型 ， 就 可 以 了 。 

现在 让 我 们 看 看 第 27 条 中 的 union Frid 下 面 是 声明 : 


public static <E> Set<E> union (Set<E> s1, Set<E> s2) 


st 和 sz 这 两 个 参数 都 是 上 消费 者 ， 因 此 根据 PECS， 这 个 声明 应 该 
日 
JE: 


public static <E> Set<E> union (Set<? extends E> s1, 


Set<? extends E> s2) 


注意 返回 类 型 仍然 是 set<e> ， 不 要 用 通配符 类 型 作为 返回 类 型 。 除 了 


为 用 户 提 供 额 外 的 灵活 性 之 外 ， 它 还 会 强制 用 户 在 客户 端 代 码 中 使 用 通 
配 符 类 型 。 

如 果 使 用 得 当 ， 通 配 符 类 型 对 于 类 的 用 户 来 说 几乎 是 无 形 的 。 它 们 使 方 
法 能 够 接受 它们 应 该 接受 的 参数 ， 并 拒绝 那些 应 该 拒绝 的 参数 。 如 果 类 
的 用 户 必须 考虑 通配符 类 型 ， 类 的 API 或 许 束 会 出 错 。 

遗憾 的 是 ， 类 型 推导 (type inference) 规则 相当 复杂 ， 在 语言 规范 中 占 
了 整整 16 页 [JLS，15.12.2.7-8]， 而 且 它 们 并 非 总 能 完成 需要 它们 完成 的 
工作 。 看 看 修改 过 的 union 声明 ， 你 可 能 会 以 为 可 以 像 这 样 编写 : 


Set<Integer> integers =... ; 














Set<Double> doubles = ... ; 


Set<Number> numbers = union(integers, doubles); 


yo AA +H pe 
但 这 么 做 会 得 到 下 面 的 错误 消息 : 
Union.java: 14 : incompatible types 
found : Set<Number & Comparable<? extends Number & 
Comparable<?>>> 
required: Set<Number> 


Set<Number> numbers = union(integers, doubles); 


A 


SAIS NN ZE, APINE AY DAA MBI WR PERS AS BE TET i 7p BE 
它 拥 有 的 类 型 ， 可 以 通过 一 个 显 式 的 类 型 参数 (explicit type 
parameter) 来 告诉 它 要 使 用 哪 种 类 型 。 这 种 情况 不 大 经 党 发 生 ， 这 是 好 
事 ， 因 为 显 式 的 类 型 参数 不 太 优 雅 。 增 加 了 这 个 显 式 的 类 型 参数 之 后 ， 
程序 可 以 正确 无 误 地 进行 编译 : 


Set<Number> numbers = Union.<Number>union(integers, doubles); 








接 下 来 ， 我 们 把 注意 力 转向 第 27 条 中 的 max 方法 。 以 下 是 初始 的 声明 : 


public static <T extends Comparable<T>> T max (List<T> list) 


下 面 是 修改 过 的 使 用 通配符 类 型 的 声明 : 
public static <T extends Comparable<? super T>> T max ( 


List<? extends T> list) 


为 了 从 初始 声明 中 得 到 修改 后 的 版 本 ， 要 应 用 PECS 转 换 两 次 。 最 直接 
的 是 运用 到 参数 list oœ 它 产 生 T 实例 ， 因此 将 类 型 从 List<T> 改 成 
List<? extends T> 。 更 灵活 的 是 运用 到 类 型 参数 + 。 这 是 我 们 第 一 次 见 
到 将 通配符 运用 到 类 型 参数 。 最 初 + 被 指定 用 来 扩展 comparable<r> ， 任 
是 T 的 comparable 消费 t+ 实例 (并 产生 表示 顺序 的 整 值 ) 。 因 此 ， 参 
数 化 类 型 Comparable<T> 被 有 限制 通配符 类 型 Comparable<? super T> 取代 。 
comparable 始终 是 消费 者 ， 因此 使 用 时 始终 应 该 是 Comparable<? super T> 
优先 于 Comparable<T> œ 对 于 comparator {He 因此 使 用 时 始终 应 该 是 


Comparable<? super T> 优先 于 Comparable<T> 


修改 过 的 max 声明 可 能 是 整 本 书 中 最 复杂 的 方法 声明 了 。 上 所 增加 的 复杂 
代码 真 的 起 作用 了 吗 ? 是 的 ， 起 作用 了 。 下 面 是 一 个 简单 的 列表 示例 ， 
在 初始 的 声明 中 不 允许 这 样 ， 修 改过 的 版 本 则 可 以 : 


List<ScheduledFuture<?>> scheduledFutures = ... ; 








不 能 将 初始 方法 声明 运用 给 这 个 列表 的 原因 在 于 ， 
java.util.concurrent.ScheduledFuture 没有 实现 Comparable<ScheduledFuture> 接 
Oo 相反 ， 它 是 扩展 Comparable<Delayed> 接口 的 Delayed 接口 的 子 接口 。 
Malai, ScheduledFuture 示例 并 非 只 能 与 其 他 ScheduledFuture 示例 相 比 
ne 
被 拒绝 。 


修改 过 的 max 声明 有 一 个 小 小 的 问题 : 它 阻止 方法 进行 编译 。 下 面 的 方 
法 包含 了 修改 过 的 声明 : 


// Won't compile - wildcards can require change in method body! 





public static <T extends Comparable<? super T>> T max ( 
List<? extends T> list) { 
Iterator<T> i = list.iterator(); 
T result = i.next(); 


while (i.hasNext()) { 


T t = i.next(); 
if (t.compareTo(result) > 0 ) 
result = t; 


} 


return result; 


DF re’ Sn ENR ERIH A: 
Max.java:7: incompatible types 
found : Iterator<capture#591 of ? extends T> 
required: Iterator<T> 


Iterator<T> i = list.iterator(); 


A 





这 条 错误 消息 意味 着 什么 ， 我 们 又 该 如 何 修正 这 个 问题 呢 ? 它 意 味 着 

list 不 是 一 个 List<T> 5 因此 它 的 iterator 方法 没有 返回 Iterator<T> o 
CBRE + 的 某 个 子 类 型 的 一 个 iterator > AUCH ER iterator 
声明 ， 它 使 用 了 一 个 有 限制 的 通配符 类 型 : 


Iterator<? extends T> i = list.iterator(); 


这 是 必须 对 方法 体 所 做 的 唯一 修改 。 迭 代 器 的 next 方法 返回 的 元 素 属 
pa Ie EE ae eee ee Eee 
还 有 一 个 与 通配符 有 关 的 话题 值得 探讨 。 类 型 参数 和 通配符 之 间 具 有 双 
重 性 ， 许 多 方法 都 可 以 利用 其 中 一 个 或 者 妨 一 个 进行 声明 。 例 如 ， 下 面 
古 可 能 的 两 种 静态 方法 声明 ， 来 交换 列表 中 的 两 个 被 索引 的 项 目 。 第 一 
个 使 用 无 限制 的 类 型 参数 〈 见 第 27 条 ) ， 第 二 个 使 用 无 限制 的 通配符 : 


// Two possible declarations for the swap method 
public static <E> void swap (List<E> list, int i, int Í) f 


public static void swap (List<?> list, int i, int j) p 


你 更 喜欢 两 种 方法 中 的 哪 一 种 呢 ? 为 什么 ? 在 公共 API 中 ， 第 二 种 更 好 
一 下 ， 因 为 它 更 简单 。 将 它 传 到 一 个 列表 中 一 一 任何 列表 一 一 方法 就 会 
交换 被 索引 的 元 素 。 不 用 担心 类 型 参数 。 一 般 来 说 ， 如 果 类 型 参数 只 在 
方法 中 出 现 一 次 ， 就 可 以 用 通配符 取代 它 。 如 果 是 无 限制 的 类 型 参 
数 ， 就 用 无 限制 的 通配符 取代 它 ; 如 果 是 有 限制 的 类 型 参数 ， 就 用 有 限 
制 的 通配符 取代 它 。 


将 第 二 种 声明 用 于 swap 方法 会 有 一 个 问题 ， 它 优先 使 用 通配符 而 非 类 
型 参数 : 下 面 这 个 简单 的 实现 都 不 能 编译 : 


public static void swap (List<?> list, int i, int j) { 











list.set(i, list.set(j, list.get(i))); 


ia at PE HY 23 AER CAT FAAS IES 
Swap.java:5: set(int,capture#282 of ?) in List<capture#282 of ?> 
cannot be applied to (int, Object) 
list.set(i, list.set(j, list.get(i))); 


A 





不 能 讲 元 素 放 回 到 刚刚 从 中 取出 的 列表 中 ， 这 似乎 不 太 对 劲 。 问 题 在 于 
list 的 类 型 为 List<?>> ， 你 不 能 把 mu 之 外 的 任何 值 放 到 List<?> 

中 。 笠 运 的 是 ， 有 一 种 方式 可 以 实现 这 个 方法 ， 无 需求 助 于 不 安全 的 转 
换 或 者 原生 态 类 型 (raw type) 。 这 种 想法 就 是 编写 一 个 私有 的 辅助 方 
ee 
这 样 : 


public static void swap (List<?> list, int i, int j) { 





swapHelper(list, i, j); 


// Private helper method for wildcard capture 
private static <E> void SwapHelper (List<E> list, int i, int j) { 


list.set(i, list.set(j, list.get(i))); 


} 


swapHelper 方法 知道 list 是 一 个 List<E> o 因此 ， 它 知道 从 这 个 列表 中 
取出 的 任何 值 均 为 © 类 型 ， 并 且 知 道 将 e 类 型 的 任何 值 放 进 列表 都 是 
安全 的 。 swap 这 个 有 些 费 解 的 实现 编译 起 来 却 是 正确 无 误 的 。 它 允许 
我 们 导出 swap 这 个 比较 好 的 基于 通配符 的 声明 ， 同 时 在 内 部 利用 更 加 
复杂 的 泛 型 方法 。 swap 方法 的 客户 端 不 一 定 要 面 对 更 加 复杂 的 
swapHelper 声明 ， 但 是 它们 的 确 从 中 受益 。 


总 而 言 之 ， 在 API 中 使 用 通配符 类 型 虽然 比较 需要 技巧 ， 但 是 使 API 变 
得 灵活 的 多 。 如 果 编 写 的 是 将 被 广泛 使 用 的 类 库 ， 则 一 定 要 适当 地 利用 
通配符 类 型 。 记 住 基 本 的 原则 : producer-extends, consumer- 
super(PECS). 还 要 记 住 所 有 的 comparable 和 comparator 都 是 消费 者 。 


第 29 条 : 优先 考虑 类 型 安全 的 异 构 容 


ANT 


泛 型 最 常用 于 集合 ， 如 Set 和 Map > 以 及 单元 素 的 容器 。 如 ThreadLocal 
和 AtomicReference o 在 这 些 用 法 中 ， 它 都 充当 被 参数 化 了 的 容器 。 这 样 
束 限 制 你 每 个 容器 只 能 有 固定 数目 的 类 型 参数 。 一 般 来 说 ， 这 种 情况 正 
是 你 想 要 的 。 一 个 set 只 有 一 个 类 型 参数 ， 表 示 它 的 元 素 类 型 ， 一 个 

map 有 两 个 类 型 参数 ， 表 示 它 的 键 和 值 类 型 ， 诸 如 此 类 。 


但 是 ， 有 时 候 你 会 需要 更 多 的 灵活 性 。 例 如 ， 数 据 库 行 可 以 有 任意 多 的 
列 ， 如 果 能 以 类 型 安全 的 方式 访问 所 有 列 束 好 了 。 斑 运 的 是 ， 有 一 种 方 
法 可 以 很 容易 地 做 到 这 一 点 。 这 种 想法 束 是 将 键 Cey) 进行 参数 化 而 
不 是 将 容器 (container) 参数 化 。 然 后 将 参数 化 的 键 提 交 给 容器 ， 来 插 
入 或 者 获取 值 。 用 泛 型 系统 来 确保 值 的 类 型 与 它 的 键 相符 。 


简单 地 示范 一 下 这 种 方法 : 考虑 Favorites 类 ， 它 允许 客户 端 从 任意 数 
量 的 其 他 类 中 ， 保 存 并 获取 一 个 “最 喜爱 ”的 实例 。 cass 对 象 充当 参数 
化 键 的 关键 部 分 。 之 所 以 可 以 这 样 ， 是 因为 类 caass 在 Java 1.5 版 本 中 
被 泛 型 化 了 。 类 的 类 型 从 字面 上 来 看 不 再 只 是 简单 的 class ， 而 是 
Class<T> oœ 例如 ， String.class 属于 Class<String> 类 型 ， Integer.class 后 
于 class<integer> 类 型 。 当 一 个 类 的 字面 文字 被 用 在 方法 中 ， 来 传达 编译 
时 和 运行 时 的 类 型 信息 是 ， 就 被 称 作 type token [Brancha04]. 
































Favorites 类 的 API 很 简单 。 它 看 起 来 就 像 一 个 简单 的 map， 除 了 键 〈 而 
不 是 map) 被 参数 化 之 外 。 客 户 端 在 设置 和 获取 最 喜爱 的 实例 时 提交 
class 对 象 。 下 面 就 是 这 个 API: 
// Typesafe heterogeneous container pattern - API 
public class Favorites { 
public <T> void putFavorite (Class<T> type, T instance) ; 


public <T> T getFavorite (Class<T> type) ; 





下 面 是 一 个 示例 程序 ， 检 验 一 下 Favorites 类 ， 它 保存 、 获 取 并 打印 一 
个 最 喜爱 的 String Integer 和 Class 实例 : 


// Typesafe heterogeneous container pattern - client 

public static void main (String[] args) { 
Favorites f = new Favorites(); 
f.putFavorite(String.class, "Java" ); 
f.putFavorite(Integer.class, Oxcafebabe ); 
f.putFavorite(Class.class, Favorites.class); 
String favoriteString = f.getFavorite(String.class); 

int favoriteInteger = f.getFavorite(Integer.class); 

Class<?> favoriteClass = f.getFavorite(Class.class); 
System.out.printf( "%s %x %s%n" , favoriteString, 


favoriteInteger, favoriteClass.getName()); 


正如 所 料 ， 这 上段 程序 打印 出 的 是 Java cafebabe Favorites o 


Favorites 实例 是 PA (typesafe ) 的 : 当 你 同 它 请 求 String 的 时 
候 ， 它 从 来 不 会 返回 一 个 integer 给 你 。 同 时 它 也 是 异 构 的 
(heterogeneous) : 不 像 普通 的 map， 它 的 所 有 键 都 是 不 同类 型 的 。 
此 ， 我 们 将 Favorites 称 作 类 型 安全 的 异 构 容 器 (typesafe heterogeneous 
container) 。 











: AY AA mS Tamed no 
Favorites 的 实现 小 得 出 奇 。 它 的 完整 实现 如 下 : 
// Typesafe heterogeneous container pattern - implementation 
public class Favorites { 
private Map<Class<?>, Object> favorites = 


new HashMap<Class<?>, Object>(); 


public <T> void putFavorite (Class<T> type, T instance) { 
if (type == null ) 
throw new NullPointerException( "Type is null" ); 


favorites.put(type, instance); 


public <T> getFavorite(Class<T> type) { 


return type.cast(favorites.get(type)); 


这 里 发 生 了 一 些微 妙 的 事情 。 每 个 Favorites 实例 都 得 到 一 个 称 作 

favorites 的 私有 Map<Class<?>, Object> 的 支持 。 你 可 能 认为 由 于 无 限 通 配 
符 类 型 的 关系 ， 将 不 能 把 任何 东西 放 进 这 个 map 中 ， 但 事实 正好 相反 。 
要 注意 的 是 通配符 类 型 是 藤 套 的 : 它 不 是 属于 通配符 类 型 的 wap 的 类 
型 ， 而 是 它 的 键 的 类 型 。 由 此 可 见 ， 每 个 键 都 可 以 有 一 个 不 同 的 参数 化 
类 型 : 一 个 可 以 是 Class<String> ， 接 下 来 是 Class<Integer> 等 等 。 异 构 就 


是 从 这 里 来 的 。 


第 二 件 要 注意 的 事情 是 ， favorites Map 的 值 类 型 只 能 是 Object oœ Mali 
说 ， wap 并 不 能 保证 键 和 值 之 间 的 类 型 关系 ， 即 不 能 保证 每 个 值 的 类 玉 
都 与 键 的 类 型 相同 。 事 实 上 ， sava 的 类 型 系统 还 没有 强大 到 足以 表达 
ate EAE OPN gorse I (SA Te 
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putFavorite 方法 的 实现 很 简单 : 它 只 是 把 (从 指定 的 Class 对 象 到 指定 
的 favorite 实例 的 ) 一 个 映射 放 到 favorites 中 。 如 前 所 述 ， 这 是 放弃 


了 键 和 值 之 间 的 “类 型 联系 ”， 因 此 无 法 知道 这 个 值 是 键 的 一 个 实例 。 但 
是 没关系 ， 因 为 getravorite 方法 能 够 并 且 的 确 重 新 建立 了 这 种 联系 。 


getFavorite 方法 的 实现 比 putFavorite 的 更 难 一 些 。 它 先 从 favorites ph 
射 中 获得 与 指定 class 对 象 相 对 应 的 值 。 这 正 是 要 返回 的 对 象 引 用 ， 但 
它 的 编译 时 类 型 是 错误 的 。 它 的 类 型 只 是 Object ( favorites 映射 的 值 
类 型 ) 我 们 需要 返回 一 个 T o 因此 ， getFavorite 方法 的 实现 利用 
class 的 cast 方法 ， 将 对 象 引用 动态 地 转换 (dynamically cast) 成 了 
Class 对 象 所 表示 的 类 型 。 


cast 方法 是 Java 的 cast 操作 符 的 动态 模拟 。 它 只 检验 它 的 参数 是 否 
为 class 对 象 所 表示 的 类 型 的 实例 。 如 果 是 ， 束 返回 参数 ; 否则 就 抛 出 
classcastException 异常 。 我 们 知道 ， getFavorite 中 的 cast 调用 永远 也 4 
会 抛 出 ClassCastException 异常 ， 并 假设 客户 端 代码 正确 无 误 地 进行 了 编 
译 。 也 就 是 说 ， 我 们 知道 favorites 映射 中 的 值 会 始终 与 键 的 类 型 相 匹 
A 


假设 cast 方法 只 返回 它 的 参数 ， 那 它 能 为 我 们 做 什么 呢 ? cast IAK 
签名 充分 利用 了 caass 类 型 被 泛 型 化 的 这 个 事实 。 它 的 返回 类 型 是 
Class 对 象 的 类 型 参数 : 


public class Class <T> { 








T cast (Object obj) ; 


} 


这 正 是 getFavorite 方法 所 需要 的 ， 也 正 是 让 我 们 不 必 借 助 于 未 受 检 地 转 
换 成 T 束 能 确保 Favorites 类 型 安全 的 东西 。 


Favorites 类 有 两 种 局 限 性 值得 注意 。 首先 ， 恶意 的 客户 端 可 以 很 轻松 
地 破坏 Favorites 实例 的 类 型 安全 ， 只 要 以 它 的 原生 态 类 型 (ray form) 
使 用 class 对 象 。 但 会 造成 客户 端 代码 在 编译 时 产生 未 受 检 的 敬告。 这 
与 一 般 的 集合 实现 ， 如 nashset 和 Hashmap 并 没有 什么 区 别 。 也 就 是 说 ， 
如 宁愿 意 付 出 一 点 点 代价 ， 融 可 以 拥有 运行 时 的 类 型 安全 。 确 保 
Favorites 永远 不 违背 它 的 类 型 约束 条 件 的 方式 是 ， 让 putFavorite 方法 
检验 instance 是 否 真 的 是 type 所 表示 的 类 型 的 实例 。 我 们 已 经 知道 这 
要 如 何 进行 了 ， 只 要 使 用 一 个 动态 的 转换 : 


// Achieving runtime type safty with a dynamic cast 














public <T> void putFavorite (Class<T> type, T instance) { 
favorites.put(type, type.cast(instance) ); 


} 


java.util.collections 中 有 一 些 集 合 包装 类 采用 了 同样 的 技巧 。 它 们 称 作 
checkedSet checkedList 、 checkedMap >» 诸如 此 类 。 除了 一 个 集合 (或 
者 映射 ) 之 外 ， 它 们 的 静态 工厂 还 采用 一 个 (或 者 两 个 ) cass 对 象 。 
静态 工厂 属于 泛 型 方法 ， 确 保 cass 对 象 和 集合 的 编译 时 类 型 相 匹 配 。 
包装 类 给 它们 所 封装 的 集合 增加 了 具体 化 。 例 如 ， 如 果 有 人 视图 将 coin 
放 进 你 的 Collection<Stamp>  ， 4,258 FS Se FE IS 47 AY E ClassCastException 
异常 。 用 这 些 包 装 类 在 混 油 泛 型 和 遗留 代码 的 应 用 程序 中 追溯 “ 谁 把 错 
误 的 类 型 元 素 添 加 到 了 集合 中 ”很 有 帮助 。 


Favorites 类 的 第 二 种 局 限 性 在 于 它 不 能 用 在 不 可 具体 化 的 Con- 
reifiable) 类 型 中 《〈 见 第 25 条 ) 。 换 名 话说， 你 可 以 保存 最 喜爱 的 

string 或 者 stringr] ， 但 不 能 保存 最 喜爱 的 List<string> 。 如 果 试 图 保 
存 最 喜爱 的 List<String> > 程序 就 不 能 进行 编译 .原因 在 于 你 无 法 为 
List<String> 获得 一 个 Class KTR: List<String>.class 是 个 语法 错误 ， 这 
也 是 件 好 事 。 List<String> 和 List<Integer> 共用 一 个 Class 对 象 ， BU 
List.class o 如 果 从 “字面 (type literal ) ”上 来 看 ， List<String>.class 和 
List<Integer>.class 是 合法 的 ， 并 返回 了 相同 的 对 象 引 用 ， 束 会 破坏 
Favorites 对 象 的 内 部 结构 o 


对 于 第 二 种 局 限 性 ， 还 没有 完全 令 人 满意 的 解决 办 法 。 有 一 种 方法 称 作 
super type token， 它 在 解决 这 一 局 限 性 方面 做 了 很 多 努力 ， 但 是 这 种 方 
法 仍然 有 它 自 喘 的 局 限 性 [Gafter07]。 


Favorites 使 用 的 类 型 令 牌 (type token) 是 无 限制 的 : getFavorite 和 
putFavorite 接受 任何 class 对 象 。 有 时 候 ， 可 能 需要 限制 那些 可 以 传 给 
方法 的 类 型 。 这 可 以 通过 有 限制 的 类 型 令 牌 (bounded type token) 来 实 
现 ， 它 只 是 一 个 类 型 令 牌 ， 利 用 有 限制 类 型 参数 〈 见 第 27 条 ) 或 者 有 限 
制 通配符 《〈 见 第 28 条 ) ， 来 限制 可 以 表示 的 类 型 。 


注解 API《〈 见 第 35 条 ) 广泛 利用 了 有 限制 的 类 型 令 牌 。 例 如 ， 这 是 一 个 
在 运行 时 读 取 注 解 的 方法 。 这 个 方法 来 自 AnnotatedElement 接口 ， 它 通过 
表示 类 、 方 法 、 域 及 其 他 程序 元 素 的 反射 类 型 来 实现 : 



































public <T extends Annotation> 


T getAnnotation (Class<T> annotationType) ; 


参数 annotationrype 是 一 个 表示 注解 类 型 的 有 限制 的 类 型 令 牌 。 如 宁 元 素 
有 这 种 类 型 的 注解 ， 访 方法 就 将 它 返回 ， 如 条 没有 ， 则 返回 nu 。 被 
注解 的 元 素 本 质 上 是 个 类 型 安全 的 腊 构 容 右 ， 容 右 的 键 属于 注解 类 型 。 


假设 你 有 一 个 类 型 Class<?> HI XT 并 且 想 将 它 传 递 给 一 个 需要 有 限制 
的 类 型 令 牌 的 方法 ， 例如 getAnnotation o 你 可 以 将 对 象 转化 成 Class<? 

extends Annotation> ， 但 是 这 种 转换 时 非 受 检 的 ， 因 此 会 产生 一 条 编译 时 
警告 〈 见 第 24 条 ) . PERE, X cas 提供 了 一 个 安全 〈 且 动态 ) 地 
执行 这 种 转换 的 实例 方法 。 该 方法 称 作 assubelass ， 它 将 调用 它 的 class 
对 象 转换 成 用 其 他 参数 表示 的 类 的 一 个 子 类 。 如 果 转 换 成 功 ， 该 方法 返 
回 它 的 参数 ， 如 果 失 败 ， 则 抛 出 classcastException 异常 。 


以 下 示范 了 如 何 利用 assubclass 方法 在 编译 时 读 取 关 型 未 知 的 注解 。 这 
个 方法 编译 时 没有 出 现 错误 或 者 警告 : 


// Use of asSubclass to safely cast to a bounded type token 





static Annotation getAnnotation (AnnotatedElement element, 
String annotationTypeName) { 
Class<?> annotationType = null ; // Unbounded type token 
try Ei 
annotationType = Class. forName(annotationTypeName) ; 
} catch (Exception ex) { 
throw new IllegalArgumentException(ex); 
} 
return element.getAnnotation( 


annotationType.asSubclass(Annotation.class)); 


总 而 言 之 ， 集 合 API 说 明了 泛 型 的 一 般 用 法 ， 限 制 你 每 个 容器 只 能 有 回 
定数 目的 类 型 参数 。 你 可 以 通过 将 类 型 参数 放 在 键 上 而 不 是 容 句 上 类 如 
开 这 一 限制 。 对 于 这 种 类 型 安全 的 寞 构 容 器 ， 可 以 用 cass 对象 作为 
键 。 以 这 种 方式 使 用 的 caass 对 象 称 作 类 型 令 牌 。 你 也 可 以 使 用 定制 的 





键 类 型 。 例 如 ， 用 一 个 patabaseRow 类 型 表示 一 个 数据 库 行 (容器 ，) ， 用 
yz AY Column<T> 作为 它 的 键 。 


HOR 枚 举 和 注解 


Java 1.5 发 行 版 本 中 增加 了 两 个 新 的 引用 类 型 家 族 : 一 种 新 的 类 称 作 枚 
举 类 型 (enum type) ， 一 种 新 的 接口 称 作 注解 类 型 (annotation 
type) 。 本 章 讨 论 使 用 这 两 个 新 的 类 型 家 族 的 最 佳 实践 。 


第 30 条 : 用 enum 代替 int 第 量 


枚 举 类 型 (enum type) 是 指 由 一 组 固定 的 常量 组 成 合法 值 的 类 型 ， 例 
如 一 年 中 的 季节 、 太 阳 系 中 的 行星 或 者 一 副 牌 中 的 花色 。 在 编程 语言 还 
没有 引入 枚 举 类 型 之 前 ， 表 示 枚 举 类 型 的 常用 模式 是 声明 一 组 具名 的 


int 常量 ， 每 个 类 型 成 员 一 个 常量 : 














// The int enum pattern - severely deficient! 
public static final int APPLE_FUJI = 0; 
public static final int APPLE_PIPPIN = 1; 


public static final int APPLE_GRANNY_SMITH = 2 ; 


public static final int ORANGE_NAVEL = 0; 
public static final int ORANGE_TEMPLE = 1 ; 


public static final int ORANGE_BLOOD = 2 ; 





这 种 方法 称 作 int 枚 举 模式 Cint enum pattern) ， 存 在 着 诸多 不 足 。 
它 在 类 型 安全 性 和 使 用 方便 性 方面 没有 任何 帮助 。 如 果 你 将 apple 
传 到 想 要 orange 的 方法 中 ， 编 译 器 也 不 会 出 现 警 告 ， 还 会 使 用 = 
操作 符 将 apple 与 orange 进行 对 比 ， 甚 至 更 糟糕 : 


// Tasty citrus flavored applesauce! 


int i = (APPLE_FUJI - ORANGE_TEMPLE) / APPLE_PIPPIN; 


注意 每 个 apple 常量 的 名 称 都 以 ape (EAHA, BES orange 常量 


则 都 以 orance, 作为 前 级 。 这 是 因为 Java 没有 为 int 枚 举 组 提供 命 
名 空间 。 当 两 个 it 枚 举 组 具有 相同 的 明明 和 党 量 时 ， 前 缀 可 以 防止 
名 称 发 生 冲 突 。 


采用 int 枚 举 模式 的 程序 是 身份 脆弱 的 。 因 为 int 枚 举 是 编译 时 
常量 ， 被 编译 到 使 用 它们 的 客户 并 中 。 如 果 域 枚 举 常 量 关 联 的 int 
发 生 了 变化 ， 客 户 端 束 必 须 重 新 编译 。 如 果 没 有 重新 编译 ， 程 厅 还 
是 可 以 运行 ， 但 是 它们 的 行为 驶 是 不 确定 的 。 


将 int 枚 举 音量 翻译 成 可 打印 的 字符 串 ， 并 没有 很 便利 的 方法 。 如 
果 将 这 种 常量 打印 出 来 ， 或 者 从 调试 器 中 将 它 显 示 出 来 ， 你 所 见 到 
的 就 是 一 个 数字 ， 这 没有 太 大 的 用 处 。 要 过 历 一 个 组 中 的 所 有 int 
Cn 
VE 


你 还 可 能 磁 到 这 种 模式 的 变 体 ， 在 这 种 模式 中 使 用 的 是 string He 

量 ， 而 不 是 it 常量 。 这 样 的 变 体 被 称 作 string 枚 举 模式 ， 同 样 
也 是 我 们 最 不 期 望 的 。 虽 然 它 为 这 些 和 常量 提供 了 可 打印 的 字符 串 ， 

但 是 它 会 导致 性 能 问题 ， 因 为 它 依 赖 于 字符 串 的 比较 操作 。 更 粳 糙 
的 是 ， 它 会 导致 初级 用 户 把 字符 串 创 两 便 编 码 到 客户 端 代码 中 ， 而 
不 是 使 用 适当 的 域 Cied) 名 。 如 果 这 样 的 人 硬 编码 字符 串 常量 中 包 
含有 书写 错误 ， 那 么 ， 这 样 的 错误 在 编译 时 不 会 被 检测 到 ， 但 是 在 
运行 的 时 候 却 会 报错 。 

ME, M Java 1.5 发 行 版 本 开始 ， 就 提出 了 另 一 种 可 以 将 代 的 
解决 方案 ， 可 以 避免 int 和 string 枚 举 模式 的 缺点 ， 并 提供 许多 
ee 
$ H: 


public enum Apple { FUJI, PIPPIN, GRANNY_SMITH } 

















public enum Orange { NAVEL, TEMPLE, BLOOD } 





表面 上 看 来 ， 这 些 枚 举 类 型 与 其 他 语言 中 的 没有 什么 两 样 ， 例 如 
C, C++ 和 C#， 但 是 实际 上 并 非 如 此 。Java 的 枚 举 类 型 是 功能 十 分 
齐全 的 类 ， 功 能 比 其 他 语言 中 的 对 等 物 要 强大 得 多 ，Java 的 枚 举 本 
质 上 是 int 值 。 


Java 枚 举 类 型 背后 的 基本 想法 非常 简单 : 它们 就 是 通过 公有 的 静态 





final 域 为 每 个 枚 举 常 量 导 出 实例 的 类 。 因 为 没有 可 以 访问 的 构造 
器 ， 枚 举 类 型 是 真正 的 final 。 因 为 客户 端 既 不 能 创建 枚 举 类 型 的 
实例 ， 也 不 能 对 它 进 行 扩展 ， 因 此 很 可 能 没有 实例 ， 而 只 有 声明 过 
的 枚 举 常 量 。 换 句 话说 ， 枚 举 类 型 是 实例 受 探 的。 它们 是 单 例 
(Singleton) 的 泛 型 化 〈 见 第 3 条 ) ， 本 质 上 是 单元 素 的 枚 举 。 对 
于 熟悉 本 书 第 一 版 的 读者 来 说 ， 枚 举 类 型 为 类 型 安全 的 枚 举 
(typesafe enum) 模式 [Bloch01， 见 第 21 条 ] 提 供 了 语言 方面 的 支 








村 
枚 举 提 供 了 编译 时 的 类 型 安全 。 如 果 声 明 一 个 参数 的 类 型 为 apple 
， 束 可 以 保证 ， 被 传 到 该 参数 上 的 任何 非 nu 的 对 象 引用 一 定 属 
于 三 个 有 效 的 ape 值 之 一 。 试 图 传递 类 型 错误 的 值 时 ， 会 导致 编 
译 时 错误 ， 就 像 试图 将 茶 种 枚 举 类 型 的 表达 式 赋 给 另 一 种 枚 举 类 型 
的 变量 ， 或 者 试图 利用 == 操作 符 比较 不 同 枚 举 类 型 的 值 一 样 。 


包含 同名 常量 的 多 个 枚 举 类 型 可 以 在 一 个 系统 中 和 平 共 处 ， 因 为 每 
个 类 型 都 有 目 己 的 命名 空间 。 你 可 以 增加 或 者 重新 排列 枚 举 类 型 中 
的 常量， 而 无 需 重 新 编译 它 的 客户 问 代 码 ， 因 为 导出 常量 的 域 在 枚 
举 类 型 和 它 的 客户 端 之 间 提 供 了 一 个 阳 离 层 ， 第 量 值 并 没有 被 编译 
到 客户 端 代码 中 ， 而 是 在 int 枚 举 模 式 中 。 最 终 ， 可 以 通过 调用 
tostring 方法 ， 将 枚 举 转 换 成 可 打印 的 字符 串 。 


除了 完善 了 im 枚 举 模式 的 不 足 之 处 ， 枚 举 类 型 还 允许 添加 人 的 方 
法 和 域 ， 并 实现 任意 的 接口 。 它 们 提供 了 所 有 oject 方法 〈 见 第 3 
= ) 的 高 级 实现 ， 实现 了 Comparable ( 见 第 12 条 ) 和 Serializable 接 
E E E E 
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那么 我 们 为 什么 要 将 方法 或 者 域 添加 到 枚 举 类 型 中 呢 ? 首先 ， 你 可 
能 是 想 将 数据 与 它 的 常量 关联 起 来 。 例 如 ， 一 个 能 够 返回 水 果 颜 色 
或 者 返回 水 果 图 片 的 方法 ， 对 于 我 们 的 apie 和 orange 类 型 来 说 可 
能 很 有 好 处 。 你 可 以 利用 任何 适当 的 方法 来 增强 枚 举 类 型 。 枚 举 类 
型 可 以 先 作为 枚 举 常量 的 一 个 简单 集合 ， 随 着 时 间 的 推移 再 演变 成 
为 全 功能 的 抽象 。 

举 个 有 关 枚 举 类 型 的 好 例子 ， 比 如 太阳 系 中 的 8 颗 行 星 。 每 颗 行 星 


都 有 质量 和 半径 ， 通 过 这 两 个 属性 可 以 计算 出 它 的 表面 重力 。 从 而 
给 定 物体 的 质量 ， 就 可 以 计算 出 一 个 物体 在 行星 表面 上 的 重量 。 下 























面 就 是 这 个 枚 举 。 每 个 枚 举 常 量 后 面 括号 中 的 数值 就 是 传递 给 构造 
器 的 参数 。 在 这 个 例子 中 ， 它 们 惑 是 行星 的 质量 和 半径 : 


// Enum type with data and behavior 





public enum Planet { 

MERCURY( 3.302e+23 , 2.439e6 ), 

VENUS ( 4.869e+24 , 6.052e6 ), 

EARTH ( 5.975e+24 , 6.378e6 ), 

MARS (96.419e+23 用 是 3.393e6 Ji 

JUPITER( 1.899e+27 , 7.149e7 ), 

SATURN ( 5.685e+26 , 6.027e7 ), 

URANUS ( 8.683e+25 , 2.566e7 ), 

NEPTUNE( 1.024e+26 , 2.477e7 ); 
private final double mass; // In kilograms 
private final double radius; // In meters 


private final double surfaceGravity; // In m / s^2 


// Universal gravitational constant in mA3 / kg s^2 


private static final double G = 6.67300E-11 ; 


// Constructor 
Planet( double mass, double radius) { 
this .mass = mass; 
this .radius = radius; 


surfaceGravity = G * mass / (radius * radius); 


public double mass () { return mass; } 
public double radius () { return radius; } 


public double surfaceGravity () { return surfaceGravity; } 


public double surfaceweight ( double mass) { 


return mass * surfaceGravity; // F = ma 


} 


编写 一 个 像 planet 这 样 的 枚 举 类 型 并 不 难 。 为 了 将 数据 与 枚 
举 常 量 关联 起 来 ， 得 声明 实例 域 ， 并 编写 一 个 带 有 数据 并 将 数 
据 保 存在 域 中 的 构造 器 。 枚 举 天 生 就 是 不 可 变 的 ， 因 此 所 有 
的 域 都 应 该 为 final 的 〈 见 第 15 条 ) 。 它 们 可 以 是 公有 的 ， 但 
最 好 将 它们 做 成 是 私有 的 ， 并 提供 公有 的 访问 方法 〈 见 第 14 
条 ) o ra Planet 这 个 示例 中 ， 构造 器 还 计算 和 保存 表面 重 
但 这 正 是 一 种 优化 。 每 当 surfaceweight 方法 用 到 重力 时 ， 
都 会 根据 质量 和 半径 重新 计算 ， 并 返回 它 在 该 常量 所 表示 的 行 
星 上 的 重量 。 

虽然 planet 枚 举 很 简单 ， 它 的 功能 却 强大 的 初期 。 下 面 是 一 
个 简短 的 程序 ， 根 据 某 个 物体 在 地 球 上 的 重量 《以 任何 单 

位 〉，， 打 印 出 一 张 很 棒 的 表格 ， 显 示 出 该 物体 在 所 有 8 绒 行 星 
上 的 重量 《用 相同 的 单位 ) : 


public class WeightTable { 




















public static void main (String[] args) { 
double earthWeight = Double.parseDouble(args[ 9 ]); 
double mass = earthWeight / Planet.EARTH.surfaceGravity(); 
for (Planet p : Planet.values()) 
System.out.printf( "Weight on %s is %f%n" , 


p, p.surfaceWeight(mass)); 


} 


注意 planet 就 像 所 有 的 枚 举 一 样 ， 它 有 一 个 静态 的 values 方 
法 ， 按 照 声明 顺序 返回 它 的 值 数组 。 还 要 注意 tostring 方法 返 
回 每 个 枚 举 值 的 声明 名 称 ， 使 得 printin 和 printf 的 打印 变 得 
更 加 容易 。 如 果 你 还 不 满足 这 种 字符 串 表 示 法 ， 可 以 通过 窗 订 
tostring 方法 对 它 进行 修改 。 下 面 就 是 用 命令 行 参数 175 运行 








这 个 小 小 的 weighttabie 程序 时 的 结 

Weight on MERCURY is 66.133672 

Weight on VENUS is 158.383926 

Weight on EARTH is 175.000000 

Weight on MARS is 66.430699 

Weight on JUPITER is 442.693902 

Weight on SATURN is 186.464970 

Weight on URANUS is 158.349709 


Weight on NEPTUNE is 198.846116 


如 果 这 是 你 第 一 次 在 实践 中 见 到 Java 的 printf 方法 ， 要 注意 
它 与 C 语 言 的 区 别 ， 你 在 这 里 用 的 是 wn ， 在 C 中 则 用 Nm o 


与 枚 举 常 量 关 联 的 有 些 行为 ， 可 能 只 需要 用 在 定义 了 枚 举 的 类 
或 者 包 中 。 这 种 行为 最 好 被 是 现成 私有 的 或 者 包 级 私有 的 方 
法 。 于 是 ， 每 个 枚 举 常 量 都 带 有 一 组 隐蔽 的 行为 ， 这 使 得 包含 
该 枚 举 的 类 或 者 包 在 过 到 这 种 常量 时 都 可 以 做 出 适当 的 反应 。 
就 像 其 他 的 类 一 样 ， 除 非 迫 不 得 已 要 将 枚 举 方法 导出 到 它 的 客 
户 端 ， 否 则 都 应 该 将 它 声明 为 私有 的 ， 如 有 必要 ， 则 声明 为 包 
级 私有 的 〈 见 第 13 条 ) 。 


如 果 一 个 枚 举 具 有 普 裔 适用 性 ， 它 就 应 该 成 为 一 个 顶层 类 
(top-level class) ; 如 果 它 只 是 被 用 在 一 个 特定 的 顶层 类 中 ， 
它 就 应 该 成 为 该 顶层 类 的 一 个 成 员 类 〈 见 第 22 条 ) 。 例 如 ， 
java.math.RoundingMode 枚 举 表示 十 进 制 小 数 的 舍 入 模式 
(rounding mode) 。 这 些 舍 入 模式 用 于 Bigpecinal 类 ， 但 是 它 
们 提供 了 一 个 非常 有 用 的 抽象 ， 这 种 抽象 本 质 上 又 不 属于 
BigDecimal 类 。 通过 使 RoundingMode 成 为 一 个 顶层 类 ， 库 的 设计 
者 喜 励 任何 需要 舍 入 模式 的 程序 员 重 用 这 枚 举 ， 从 而 增强 API 
之 间 的 一 致 性 。 


planet 示例 中 所 示 的 方法 对 于 大 多 数 枚 举 类 型 来 说 束 足 够 
了 ， 但 你 有 时 候 会 需要 更 多 的 方法 。 每 个 planet 常量 都 关联 
了 不 同 的 数据 ， 但 你 有 时 需要 将 本 质 上 不 同 的 行为 
(behavior) 与 每 个 常量 关联 起 来 。 例 如 ， 假 设 你 在 编写 一 个 
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想 要 提供 一 个 方法 来 执行 每 个 常量 所 表示 的 算术 运算 。 有 一 种 
方法 是 通过 局 用 枚 举 的 值 来 实现 : 


// Enum type that switches on its own value - questionable 





public enum Operation { 


PLUS, MINUS, TIMES, DIVIDE; 


// Do th arithmetic op represented by this constant 
double apply ( double x, double y) { 


switch ( this ) { 


case PLUS: return x+y; 
case MINUS: return x - y; 
case TIMES: return x * y; 


case DIVIDE: return x / y; 


throw new AssertionError( "Unknown op: " + this ); 





这 段 代 码 可 行 ， 但 是 不 太 好 看 。 如 果 没 有 swith 语句 ， 它 就 
不 能 编译 ， 虽 然 从 技术 角度 来 看 代码 的 结束 部 分 是 可 以 执行 到 
的 ， 但 是 实际 上 是 不 可 能 执行 到 这 行 代码 的 [JLS，14.2.1]。 | 
糟 料 的 是 ， 这 有 段 代码 很 脆弱 。 如 果 你 添加 了 新 的 枚 举 和 常量， 去 
忘记 给 switch 添加 相应 的 条 件 ， 枚 举 仍 然 可 以 编译 ， TH 
你 试图 运行 新 的 运算 时 ， 束 会 运行 失败 。 


幸运 的 是 ， 有 一 种 更 好 的 方法 可 以 将 不 同 的 行为 与 每 个 枚 举 常 

量 关 联 起 来 : 在 枚 举 类 型 中 声明 一 个 抽象 的 apy 方法 ， 并 在 

特定 于 常量 的 类 主题 (constant-specific class body) +, MRA 

体 的 方法 覆 王 每 个 常量 的 抽象 apply 方法 。 这 种 方法 被 和 KE 特 
定 于 常量 的 方法 实现 (constant-specific method 

implementation ) 

















// Enum type with constant-specific method implementations 


public enum Operation { 


PLUS { double apply ( double x, double y) { return 
x+y;}}, 


MINUS { double apply ( double x, double y) { return 
x - y;}}, 
TIMES { double apply ( double x, double y) { return 
x* y;}}, 


DIVIDE { double apply ( double x, double y) { return 
x / yi} ji; 





abstract double apply ( double x, double y) ; 


如 果 给 operation 的 第 二 种 版 本 添加 新 的 常量 ， 你 就 不 可 能 会 
mise He apply 方法 ， 因 为 该 方法 就 紧 跟 在 每 个 常量 声明 之 

后 。 即 使 你 真 的 态 记 了 ， 编 译 器 也 会 提醒 你 ， 因 为 没 大 中 的 抽 
象 方法 必须 被 它 所 有 的 常量 中 的 具体 方法 所 窗 盖 。 

特定 于 常量 的 方法 实现 可 以 与 特定 于 常量 的 数据 结合 起 来 。 例 
如 ， 下 面 的 operation iti J tostring 来 返回 通常 与 该 操作 关 
联 的 符号 : 


// Enum type with constant-specific class bodies and data 











public enum Operation { 
PLUS( "+" ) { 


double apply ( double x, double y) { return x+y; } 


外 
MINUS( "-" ) { 

double apply ( double x, double y) { return x - y; } 
}, 


TIMES( "*" ) { 
double apply ( double x, double y) return BX y 


} 


DIVIDE( "/" ) { 


double apply ( double x, double y) { return x/vy; } 
}; 
private final String symbol; 
Operation(String symbol) { this .symbol = symbol; } 


@Override public String toString () { return symbol; } 


abstract double apply ( double x, double y) ; 


FEA EET F, EARE tostrin 非常 有 用 。 例 如 ， 
上 述 的 tostring 实现 使 得 打印 算术 表达 式 变 得 非常 容易 ， 
如 这 段 小 程序 所 示 : 


public static void main (String[] args) { 





double x = Double.parseDouble(args[ 0 ]); 

double y = Double.parseDouble(args[ 1 ]); 

for (Operation op : Opetation.values()) 
System.out.printf( "%f %s %f = %f%n" , 


X, Op, y, Op.apply(x, y)); 


用 2 和 4 作为 命令 行 参 数 运行 这 段 程序 后 ， 会 输出 : 


2.000000 + 4.000000 = 6.000000 
2.000000 - 4.000000 = - 2.000000 
2.000000 * 4.000000 = 8.000000 
2.000000 / 4.000000 = 0.500000 


枚 举 类 型 有 一 个 目 动 产生 的 valueOf (String) 方法 ， 它 将 常 
量 的 名 字 转 变 成 为 常量 本 里 。 如 果 在 枚 举 类 型 中 宪 瘟 
toString » 要 考虑 编写 一 个 fromString FYE, 将 定制 的 字 
符 串 表示 法 变 回 相应 的 枚 举 。 下 列 代码 〈 适 当地 改变 了 类 
型 名 称 ) 可 以 为 任何 枚 举 完成 这 一 技巧 ， 只 要 每 个 常量 都 
有 一 个 独特 的 字符 串 表 示 法 : 








// Implementation a fromString method on an enum type 
private static final Map<String, Operation> stringToEnum 
= new HashMap<String, Operation>(); 
static { // Initialize map from contant name to enum constant 
for (Operation op : values()) 
stringToEnum.put(op.toString(), op); 


} 
// Returns Operation for String, or null if string is invalid 
public static Operation fromString (String symbol) { 


return stringToEnum.get(symbol); 


注意 ， 在 常量 被 创建 之 后 ， operation 常量 从 静态 代码 块 
中 被 放 入 到 了 stringToEnum 的 map 中 。 试图 使 每 个 变量 都 
从 上 自己 的 构造 器 将 自身 放 入 到 map 中 ， 会 导致 编译 时 错 
误 。 这 是 好 事 ， 因 为 如 果 这 是 合法 的 ， 就 会 抛 出 
NullPointerException 异常 。 枚 举 构造 器 不 可 以 访问 枚 举 的 
静态 域 ， 除 了 编译 时 第 量 之 外 。 这 一 限制 是 有 必要 的 ， 因 
为 构造 器 运行 的 时 候 ， 这 些 静态 域 还 没有 被 初始 化 。 


特定 于 常量 的 方法 实现 有 一 个 美中不足 的 地 方 ， 它 们 使 得 
在 枚 举 和 常量 中 共享 代码 变 得 更 加 困难 了 。 例 如 ， 考 虑 用 一 
个 枚 举 表示 薪资 包 中 的 工作 天 数 。 这 个 枚 举 有 一 个 方法 ， 
根据 给 定 某 工 人 的 基本 工资 〈 按 小 时 ) 以 及 当天 的 工作 时 
间 ， 来 计算 他 当天 的 报酬 。 在 五 个 工作 日 中 ， 超 过 正常 八 
小 时 的 工作 时 间 都 会 产生 加 班 工资 ;在 双休日 中 ， 所 有 工 
作 都 产生 加 班 工资 。 利 用 switch 语句 ， 很 容易 通过 将 多 
AR case IN EY Fal DV BP AS RAS Fr BP, 来 完成 这 一 计 
算 。 为 了 简洁 起 见 ， 这 个 示例 中 的 代码 使 用 了 double ， 

但 是 注意 double 并 不 是 适合 薪资 应 用 程序 ( 见 第 48 条 ) 

的 数据 类 型 。 


// Enum that switches on its value to share code - questionable 

















enum PayrollDay { 


MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, 


SATURDAY, SUNDAY; 
private static final int HOURS PER SHIFT = 8 ; 
double pay ( double hourswWorked, double payRate) { 


double basePay = hoursWorked * payRate; 


double overtimePay; // Calculate overtime pay 
switch ( this ) { 
case SATURDAY: case SUNDAY 
overtimePay = hoursWorked * payRate / 2 ; 
default : // Weekdays 
overtimePay = hoursWorked <= HOURS_PER_SHIFT ? 


© : (hoursWorked - HOURS_PER_SHIFT) * payRate / 


break ; 


return basePay + overtimePay; 


不 可 人 否认， 这 段 代 码 十 分 简洁 ， 但 是 从 维护 的 角度 来 看 ， 
它 十 分 危险 。 假 设 将 一 个 元 素 添 加 到 该 枚 举 中 ， 或 许 古 一 
个 表示 假期 天 数 的 特殊 值 ， 但 是 乐 记 给 switen 语句 添加 
相应 的 case 。 程 序 依然 可 以 编译 ， 但 pay 方法 会 悄悄 地 
将 假期 的 工资 计算 成 与 正常 工作 日 的 相同 。 


为 了 利用 特定 于 常量 的 方法 实现 安全 地 执行 工资 计算 ， 你 
可 能 必须 重复 计算 每 个 常量 的 加 班 工资 ， 或 者 将 计算 移 到 
两 个 辅助 方法 中 (一 个 用 来 计算 工作 日 ， 一 个 用 来 计算 双 
休 日 ) ， 并 从 每 个 常量 调用 相应 的 辅助 方法 。 这 任何 一 种 
方法 都 会 产生 相当 数量 的 样板 代码 ， 结 末 降 低 了 可 读 性 ， 
并 增加 了 出 错 的 机 率 。 








通过 用 计算 工作 日 加 班 工资 的 具体 方法 代替 payroutoay 中 
抽象 的 _wertinepay 方法 ， 可 以 减少 样板 代码 。 这 样 ， 就 只 
用 双休日 必须 覆盖 该 方法 了 。 但 是 这 样 也 有 着 与 swite 
语句 一 样 的 不 足 ， 如 果 有 增加 了 一 天 而 没有 覆盖 
overtineray 方法 ， 就 会 悄悄 地 延续 工作 日 的 计算 。 


你 真正 想 要 的 就 是 每 当 添 加 一 个 枚 举 常 量 时 ， 束 强制 选 
择 一 种 加 班 报酬 策略 。 幸 运 的 是 ， 有 一 种 很 好 的 方法 可 以 
实现 这 一 点 。 这 种 想法 就 是 将 加 班 工资 计算 移 到 一 个 私有 
RE ASH, KS 策略 枚 举 (strategy enum) 的 实例 
传 到 PayrollDay 枚 举 的 构造 器 中 。 之 后 PayrollDay 枚 举 将 
加 班 工资 计算 委托 给 策略 枚 举 ， payrolloay 中 就 不 需要 
switch 语句 或 者 特定 于 常量 的 方法 实现 了 。 虽 然 这 种 模 
~ switch 语句 那么 简洁 ， 但 更 加 安全 ， 也 更 加 灵 
YA: 


// The strategy enum pattern 




















enum PayrollDay { 
MONDAY (PayType.WEEKDAY), TUESDAY(PayType.WEEKDAY), 
WEDNESDAY (PayType .WEEKDAY), THURSDAY (PayType.WEEKDAY), 
FRIDAY (PayType.WEEKDAY), 


SATURDAY (PayType.WEEKEND), SUNDAY(PayType.WEEKEND) ; 


private pay ( double hoursWorked, double payRate) { 
return payType.pay(hoursWorked, payRate); 
} 
// The strategy enum type 
private enum PayType { 
WEEKDAY { 


double overtimePay ( double hours, double 
payRate) { 


return hours <= HOURS _PER_SHIFT ? 0 


(hours - HOURS _PER_SHIFT) * payRate / 2 ; 


}, 


WEEKEND { 


double overtimePay ( double hours, double 
payRate) { 


return hours * payRate / 2 ; 


}; 


private static final int HOURS_PER_SHIFT = 8 


abstract double overtimePay ( double hours, 
double payRate) ; 


double pay ( double hoursworked, double payRate) 


{ 
double basePay = hoursWorked * payRate; 
return 
basePay + overtimePay(hoursworked, payRate); 
} 
} 
} 





如 果 枚 举 中 的 switen 语句 不 是 在 没 居中 实现 特定 于 
常量 的 行为 的 一 种 很 好 的 选择 ， 那 么 它们 还 有 什么 用 
ARIE? 枚 举 中 的 switen 语句 适合 于 给 外 部 的 枚 举 类 
型 增加 特定 于 和 常量 的 行为 。 例 如 ， 假 设 operation PM 
举 不 受 你 的 控制 ， 你 希望 它 有 一 个 实例 方法 来 返回 每 
e 你 可 以 用 下 列 静 态 方法 模拟 这 种 效 


// Switch on an enum to simulate a missing method 











public static Operation inverse (Operation op) { 
switch (op) { 
case PLUS: return Operation.MINUS; 
case MINUS: return Operation.PLUS; 


case TIMES: return Operation.DIVIDE; 


case DIVIDE: return Operation.TIMES; 


default : throw new AssertionError( 
"Unkown op: " + op); 


} 
} 


一 般 来 说 ， 枚 举 会 优先 使 用 comparable MAE int 党 

量 。 与 it 常量 相 比 ， 枚 举 有 个 小 小 的 性 能 缺点 ， 即 
装 在 和 初始 化 枚 举 时 会 有 空间 和 时 间 的 成 本 。 除 了 受 
资源 约束 的 设备 ， 例 如 手机 和 烤 面 包机 之 外 ， 在 实践 
中 不 必 太 在 意 这 个 问题 。 


那么 什么 时 候 应 该 使 用 枚 举 呢 ? 每 当 需 要 一 组 固定 党 
量 的 时 候 。 当 然 ， 这 包括 “天 然 你 的 枚 举 类 型 >， 例 如 
行星 、 一 周 的 天 数 以 及 棋子 的 数目 等 等 。 但 它 也 包括 
你 在 编译 时 残 知 道 其 所 有 可 能 值 的 其 他 集合 ， 例 如 有 亲 
单 的 选项 、 操 作 代码 以 及 命令 行 标 记 等 。 枚 举 类 型 中 
的 常量 集 并 不 一 定 要 始终 保持 不 变 。 专 门 设计 枚 举 特 
性 是 考虑 到 枚 举 类 型 的 二 进 制 兼容 演变 。 


总 而 言 之 , 与 int 常量 相 比 ， 枚 举 类 型 的 优势 是 不 言 
而 喻 的 。 枚 举 要 易 读 得 多 ， 也 更 加 安全 ， 功 能 更 加 强 
大 。 许 多 枚 举 都 不 需要 显 式 的 构造 器 或 者 成 员 ， 但 许 
多 其 他 枚 举 则 受益 于 “每 个 间 量 与 属性 的 关联 ?以 

及 “提供 行为 受 这 个 属性 影响 的 方法 "?。 只 有 极 少 数 的 
枚 举 受 益 于 将 多 种 行为 与 单个 方法 关联 。 在 这 种 相对 
少见 的 情况 下 ， 特 定 于 常量 的 方法 要 优先 于 局 用 自 有 
值 的 枚 举 。 如 果 多 个 枚 举 常量 同时 共 至 相同 的 行为 ， 

则 考虑 策略 枚 举 。 


第 31 条 : H KPR E re BL 


许多 枚 举 天 生 就 与 一 个 单独 的 int 值 相关 联 。 所 有 的 
枚 举 都 有 一 个 ordinal DIK, CREENA E EE 
类 型 中 的 数字 位 置 。 你 可 以 试 着 从 序数 中 得 到 关联 的 


int 














// Abuse of ordinal to derive an associated value - DON'T DO THIS 


public enum Ensemble { 
SOLO, DUET, TRIO, QUARTET, QUINTET, 


SEXTET, SEPTET, OCTET, NONET, DECTET; 


public int numberOfMusicians{ return 
ordinal() + 1; } 


} 





虽然 这 个 枚 举 不 错 ， 但 是 维护 起 来 就 想 一 场 恶 楚 。 如 
果 铝 量 进行 重新 排序 ， numberOfMusicians 方法 就 会 遭 到 
破坏 。 如 果 要 再 添加 一 个 与 已 经 用 过 的 int 值 关 联 的 
枚 举 常量 ， 就 没 那 么 走运 了 。 例 如 ， 给 双 四 重奏 
(double quartet) 添加 一 个 常量 ， 它 就 像 个 八重 矢 一 
样 ， 是 由 8 位 演奏 家 组 成 ， 但 是 没有 办 法 做 到 。 

要 是 没有 给 所 有 这 些 int 值 添加 常量 ， 也 无 法 给 某 个 
int 值 添 加 常量 。 例 如 ， 假 设想 要 添加 一 个 常量 表示 
三 四 重奏 (triple quartet) ， 它 由 12 位 演奏 家 组 成 。 
对 于 由 11 位 演奏 家 组 成 的 合奏 曲 并 没有 标准 的 术语 ， 
因此 只 好 给 没有 用 过 的 int 值 (11) 添加 一 个 虚拟 
(dummy) 常量 。 这 么 做 顶 多 束 是 不 太 好 看 。 如 果 有 
许多 int 值 都 是 从 未 用 过 的 ， 可 就 不 切实 际 了 。 
幸运 的 是 ， 有 一 种 很 简单 的 方法 可 以 解决 这 些 问题 。 
永远 不 要 根据 枚 举 的 序数 导出 与 它 关 联 的 值 ， 而 是 要 
将 它 保 存在 一 个 实例 域 中 : 


public enum Ensemble { 











SOLO( 1 ), DUET( 2 ), TRIO( 3 ), QUARTET( 4 
), QUINTET( 5 ), 


SEXTET( 6 ), SEPTET( 7 ), OCTET( 8 ), DOUBLE_QUARTET( 
8 ), 


NONET( 9 ), DECTET( 10 ), TRIPLE_QUARTET( 12 ); 


private final int numberOfMusicians; 


Ensemble( int size) { this 
.-numberOfMusicians = size; } 


public int numberOfMusicians{ return 
numberOfMusicians; } 


} 


Enum 规范 中 谈 到 ordinal 时 这 么 写 到 : 





“大 多 数 程序 员 都 不 需要 这 个 方法 。 它 是 设计 成 
用 于 像 EnumSet 和 EnumMap 这 种 基于 枚 举 的 通用 数 
据 结 构 的 。” 


除非 你 在 编写 的 是 这 种 数据 结构 ， 人 否则 最 好 完全 避免 
使 用 ordinal 方法 。 
第 32 条 : 用 EnumSet 代 答 位 


域 


如 果 一 个 枚 举 类 型 的 元 素 主要 用 在 集合 中 ， 一 般 就 是 
用 ine 枚 举 模式 ( 见 第 30 条 ) ， 将 2 的 不 同 倍数 赋予 


每 个 常量 ; 








// Bit field enumeration constants - OBSOLETE! 
public class Text { 


public static final int STYLE_BOLD = 
1 Ec- mo BW//1 


public static final int STYLE_ITALIC = 
1 Bc GR // 2 


public static final int STYLE_UNDERLINE = 
1 Ecm 风量 /7 4 


public static final int STYLE_STRIKETHROUGH = 
1 Races BM// 8 


// parameter is bitwise OR of zero or more STYLE_ constants 


public void applyStyles ( int styles) oes 1 


这 种 表示 法 让 你 用 or 位 运算 将 几 个 常量 合并 到 
一 个 集合 中 ， 称 作 位 域 (bit field) : 


text.applyStyles(STYLE_BOLD | STYLE_ITALIC); 


位 域 表示 法 也 允许 利用 位 操作 ， 有 效 地 执行 像 
union (联合 ) 和 intersection (2042) 这 样 的 集合 
操作 。 但 位 域 有 着 int 枚 举 和 常量 的 所 有 缺点 ， 其 
至 更 多 。 当 位 域 以 数字 形式 打印 时 ， 翻 译 位 域 比 
翻译 简单 的 int 枚 举 和 常量 要 困难 得 多 。 其 至， 要 
裔 历 位 域 表 示 的 所 有 元 素 也 没有 很 容易 的 方法 。 


有 些 程序 员 优 先 使 用 枚 举 而 非 int 和 常量， 他 们 在 
需要 传递 多 组 常量 集 时 ， 仍 然 倾 同 于 使 用 位 域 。 
其 实 没 有 理由 这 么 做 ， 因 为 还 有 更 好 的 替代 方 
法 。 java.util 包 提 供 了 EnumSet 类 来 有 效 地 表示 
从 单个 枚 举 类 型 中 提取 的 多 个 值 的 多 个 集合 。 这 
个 类 实现 set 接口 ， 提 供 了 丰富 的 功能 、 类 型 安 
全 性 ， 以 及 可 以 从 任何 其 他 set 实现 中 得 到 的 互 
用 性 。 但 是 在 内 部 具体 的 实现 上 ， 每 个 Enumset 
内 容 都 表示 为 位 矢量 。 如 果 底 层 的 枚 举 类 型 有 64 
个 或 者 更 少 的 元 素 一 一 大 多 如 此 一 一 整个 
Enumset 就 是 用 单个 lon 来 表示 ， 因 此 它 的 性 能 
比 得 上 位 域 的 性 能 。 批 处 理 ， 如 removeAll 和 
retainAll ; 都 是 利用 位 算法 来 实现 的 ， WAF 
TF DSRS ABE. 17n E aF TEET 
容易 出 现 的 错误 以 及 不 太 雅 观 的 代码 ， 因 为 
enumset 蔡 你 完成 了 这 项 艰巨 的 工作 。 


下 面 是 一 个 范例 改 成 用 枚 举 代 丛 位 域 后 的 代码 ， 
它 更 加 人 简短、 更 加 清楚 ， 也 更 加 安全 : 


// EnumSet - a modern replacement for bit fields 


























public class Text { 


public enum 
Style { BOLD, ITALIC, UNDERLINE, STRIKETHROUGH } 


// Any Set could be passed in, but EnumSet is clearly best 


public void applyStyles (Set<Style> styles) 


{ 


下 面 是 将 EnumSet 实例 传递 给 applyStyles 方法 的 
客户 端 代码 。 EnumSet 提供 了 丰富 的 静态 工厂 来 
轻松 创建 集合 ， 其 中 一 个 如 这 个 代码 所 示 : 


text.applyStyles(EnumSet.of(Style.BOLD, Style.ITALIC)); 


注意 applystyles 方法 采用 的 是 set<styles> 而 非 
EnumSet<Style> o 虽然 看 起 来 好 像 所 有 的 客户 端 都 
可 以 将 Enumset 传递 到 这 个 方法 ， 但 是 最 好 还 是 
接受 接口 类 型 而 非 接受 实现 类 型 。 这 是 考虑 到 可 
能 会 有 特殊 的 客户 端 要 传递 一 些 其 他 的 set SK 
现 ， 并 且 没 有 什么 明显 的 缺点 。 


忆 而 言 之 ， 正式 因为 枚 举 类 型 要 用 在 集合 
(Set) 中 ， 所 以 没有 利用 用 位 域 来 表示 它 。 
Enumset 类 和 集 位 域 的 简洁 和 性 能 优势 及 第 30 条 中 
所 述 的 枚 举 类 型 的 所 有 优点 于 一 身 。 实 际 上 
EnumSet 有 个 缺点 ， 即 截止 Java 1.6 发 行 版 本 ， 
它 都 无 法 创建 不 可 变 的 EnumSet ， 但 是 这 一 点 很 
可 能 在 即将 出 来 的 版 本 中 得 到 修正 。 同 时 ， 可 以 
用 Collections.unmodifiableSet 将 EnumSet 封装 起 
来 ， 但 是 简洁 性 和 性 能 会 受到 影响 。 

















第 33 条 : 用 enummap 代 符 序数 索引 


有 时 候 ， 你 可 能 会 见 到 利用 ordinal 方法 〈 见 第 31 条 ) 来 索引 数组 的 代 
码 。 例 如 下 面 这 个 过 于 简化 的 类 ， 用 来 表示 一 种 京 饪 用 的 香草 : 


public class Hurb { 





public enum Type { ANNUAL, PERENNIAL, BIENNIAL } 


private final String name, 


private final Type type; 


Herb(String name, Type type) { 
this .name = name; 


this .type = type; 


@Override public String toString () { 


retuan name; 


(BLE A-ha SEL, REEERE, TRE EH BR Se 
一年生、 多 年 生 或 者 两 年 生 植物 ) 进行 组 织 之 后 将 这 些 植物 列 出 来 。 
如 果 要 这 么 做 的 话 ， 需 要 构建 三 个 集合 ， 每 种 类 型 一 个 ， 并 且 明 有 历 整 座 
伦 园 ， 将 每 种 香草 放 到 相应 的 集合 中 。 有 些 程序 员 会 将 这 些 集 合 放 到 一 
个 按照 类 型 的 序数 进行 索引 的 数组 中 来 实现 这 一 点 。 
// Using ordinal() to index an array - DON'T DO THIS! 

Herb[] garden = ...; 
Set<Herb>[] herbsByType = // Indexed by Herb.type.ordinal() 


(Set<Herb>[]) new Set[Herb.Type.values().lenght]; 


for ( int i= 0 ; i < herbsByType.length; i++) 


herbsByType[i] = new HashSet<Herb>(); 


for (Herb h : garden) 


herbsByTyp[h.type.ordinal()].add(h); 


// Print the results 
for ( int i= 0 ; i < herbsByType.length; i++) { 
System.out.printf( "%s: %s%n" , 


Herb. Type.values()[i], herbsByType[i]) ; 





这 种 方法 的 确 可 行 ， 但 是 隐藏 着 许多 问题 。 因 为 数组 不 能 与 泛 型 〈 见 第 
25 条 ) 兼容 ， 程 序 需 要 进行 未 受 检 的 转换 ， 并 且 不 能 进行 正确 无 误 的 编 
译 。 因 为 数组 不 知道 它 的 索引 代表 着 什么 ， 你 必须 手工 标注 Aabel X 
些 索 引 的 输出 。 但 是 这 种 方法 最 严重 的 问题 在 于 ， 当 你 访问 一 个 按照 枚 
举 的 序数 进行 索引 的 数组 时 ， 使 用 正确 的 int (EE PRAYER S; int 
不 能 提供 枚 举 的 类 型 安全 。 你 如 果 使 用 了 错误 的 值 ， 程 序 束 会 悄悄 地 完 
成 错误 的 工作 ， 或 者 幸运 的 话 ， 会 抛 出 ArrayIndexOutOfBoundException ae 
常 。 


幸运 的 是 ， 有 一 种 更 好 的 方法 可 以 达到 同样 的 效果 。 数 组 实际 上 充当 着 
从 枚 举 到 值 的 映射 ， 因 此 可 能 还 要 用 到 mp 。 更 具体 地 次， 有 一 种 非 党 
快速 的 wap 实现 专门 用 于 枚 举 键 ， 称 作 java.util.Enummap 。 以 下 惑 是 用 
java.util.EnumMap 改写 后 的 程序 : 


// Using an EnumMap to associate data with an enum 














Map<Herb.Type, Set<Herb>> herbsByType = 
new EnumMap<Herb.Type, Set<Herb>>(Herb.Type.class); 
for (Herb.Type t : Herb. Type.values()) 
herbsByType.put(t, new HashSet<Herb>()); 
for (Herb h : garden) 


herbsByType.get(h.type).add(h); 


System.out.println(herbsByType) ; 





这 段 程序 更 简短 、 更 清楚 ， 也 更 加 安全 ， 运 行 速 度 方 面 可 以 与 使 用 序数 
的 程序 相 媲 美 。 它 没有 不 安全 的 转换 ;不 必 手 工 标注 这 些 索引 的 输出 ， 
因为 映射 键 知道 如 何 将 自身 翻译 成 可 打印 字符 串 的 枚 举 ， 计 算数 组 索引 
时 也 不 可 能 出 错 。 Enummap 在 运行 速度 方面 之 所 以 能 与 通过 序数 索引 的 
数组 相 媲美 ， 是 因为 enummap 在 内 部 使 用 了 这 种 数组 。 但 是 它 对 程序 员 
隐藏 了 这 种 实现 细节 ， 集 wap 的 丰富 功能 和 类 型 安全 与 数组 的 快速 与 一 
F- 注意 EnumMap 构造 器 采用 键 类 型 的 Class WR: 这 是 一 个 有 限制 的 
类 型 令 牌 (bounded type token) ， 它 提供 了 运行 时 的 泛 型 信息 〈 见 第 29 
oe) 


你 还 可 能 见 到 按照 序数 进行 索引 《两 次 ) 的 数组 的 数组 ， 该 序数 表示 两 
个 枚 举 值 的 映射 。 例 如 ， 下 面 这 个 程序 就 是 使 用 这 样 一 个 数组 将 两 个 阶 
段 映 射 到 一 个 阶段 过 渡 中 《从 液体 到 固体 称 作 凝固 ， 从 液体 到 气体 称 作 
沸腾 ， 诸 如 此 类 ) 。 


// Using ordinal() to index array of arrays - DON'T DO THIS! 











public enum Phase { SOLID, LIQUID, GAS; 
public enum Transition { 
MELT, FREEZE, BOIL, CONDENSE, SUBLIME, DEPOSIT; 
// Rows indexed by src-ordinal, cols by dst-ordinal 


private static final Transition[][] TRANSITIONS = { 


{ null, MELT, SUBLIME }, 
{ FREEZE, null, BOIL 1 
{ DEPOSIT, CONDENSE, null } 


}; 


// Returns the phase transition from one phase to another 
public static Transition from (Phase src, Phase dst) { 


return TRANSITIONS[src.ordinal()][dst.ordinal()]; 








这 段 程序 可 行 ， 看 起 来 也 比较 优雅 ， 但 是 事实 并 非 如 此 。 就 想 上 面 那个 
比较 简单 的 香草 花园 的 示例 一 样 ， 编 译 器 无 法 知道 序数 和 数组 索引 之 间 
的 关系 。 如 果 在 过 渡 表 中 出 了 错 ， 或 者 在 修改 Phase 或 者 
Phase.Transition 枚 举 类 型 的 时 候 忘 记 将 它 更 新 ， 程序 就 会 在 运行 时 失 
败 。 这 种 失败 的 形式 可 能 为 ArrayIndexOutOfBoundsException 、 
NullpointerException 或 者 (更 糟糕 的 是 ) 没有 任何 提示 的 错误 行为 。 这 
张 表 的 大 小 是 阶段 个 数 的 平方 ， 即 使 非 nu 项 的 数量 比较 少 。 


同样 ， 利 用 enumwap 依然 可 以 做 得 更 好 一 些 。 因 为 每 个 阶段 过 渡 都 是 通 
过 一 对 阶段 枚 举 进行 索引 的 ， 最 好 将 这 种 关系 表示 为 一 个 map ， 这 个 
map 的 键 是 一 个 枚 举 〈( 其 实 阶 段 )， 值 为 男 一 个 mp ， 这 第 二 个 map 
的 键 为 第 二 个 枚 举 ( 目 标 阶段 ，， 它 的 值 为 结果 阶段 过 渡 ) ， 即 形成 
了 mp (CHEE, map 【〔 目 标 阶段 ， 阶 段 过 渡 ) ) 这 种 形式 。 一 个 
阶段 过 渡 所 关联 的 两 个 阶段 ， 最 好 通过 “数据 与 阶段 过 波 枚 举 之 间 的 关 
联 ” 来 获取 ， 之 后 用 该 阶段 过 渡 枚 举 来 初始 化 授 套 的 Enunvap o 

// Using a nested EnumMap to associate data with enum pairs 

public enum Phase { 


SOLID, LIQUID, GAS; 


public enum Transition { 
MELT(SOLID, LIQUID), FREEZE(LIQUID, SOLID), 
BOIL(LIQUID, GAS), | CONDENSE(GAS, LIQUID), 


SUBLIME(SOLID, GAS), DEPOSIT(GAS, SOLID); 


private final Phase src; 


private final Phase dst; 


Transition(Phase src, Phase dst) { 
this .sre = src; 
this .dst = dst; 

} 

// Initialize the phase transition map 


private static final Map<Phase, Map<Phase, Transition>> m = 


new EnumMap<Phase, Map<Phase, Transition>>(Phase.class); 
static { 
for (Phase p : Phase.values()) 
m.put(p, new EnumMap<Phase, Transition>(Phase.class)); 
for (Transition trans : Transition.value()) 


m.get(trans.src).put(trans.dst, trans); 


public static Transition from (Phase src, Phase dst) { 


return m.get(src).get(dst); 


} 


初始 化 阶段 过 渡 map PURO A HEA AZAR, (ELE AN EAE o 
map 的 类 型 为 Map<Phase, Map<Phase, Transition>> ， 表示 是 由 键 为 源 Phase 

〈 即 第 一 个 phase ) 、 值 为 另 一 个 map 组 成 的 Map > 其 中 组 成 值 的 ma 
是 由 键 值 对 目标 Phase ( 即 第 二 个 Phase ) N Transition 组 成 的 。 静态 
初始 化 代码 块 中 的 第 一 个 循环 初始 化 了 外 部 mp ， 得 到 了 三 个 空 的 内 容 
map 。 代 码 块 中 的 第 二 个 循环 利用 每 个 状态 过 渡 常 量 提 供 的 起 始 信息 和 
目标 信息 初始 化 了 内 部 map o 


现在 假设 想 要 给 系统 添加 一 个 新 的 阶段 ， plasma CAF) 或 者 电离 气 
体 。 只 有 两 个 过 渡 与 这 个 阶段 关联 电离 化 ， 它 将 气体 变 成 离子 ， 以 及 
消 电 离 化 ， 将 离子 变 成 气体 。 为 了 更 新 基于 数组 的 程序 ， 必 须 给 Phase 
添加 一 种 新 常量 ， 给 phase.transition 添加 两 种 新 常量 ， 用 一 种 新 的 16 
个 元 素 的 版 本 取代 原来 9 个 元 素 的 数组 的 数组 。 如 果 给 数组 添加 的 元 素 
过 多 或 者 过 少 ， 或 者 元 素 放 置 不 当当 ， 可 就 碎 烦 了 : 程序 可 以 编译 ， 但 
是 会 在 运行 时 失败 。 为 了 更 新 基于 enumwap 的 版 本 ， 所 要 做 的 就 是 必须 
将 prasma 添加 到 phase 列表 ， 并 将 rowrze ( cas , pasma ) 和 
DEIONIZE ( PLAsSMA ， cas ) 添加 到 phase.transition 的 列表 中 。 程 序 会 | 
行 处 理 所 有 其 他 的 事情 ， 你 几乎 没有 机 会 出 错 。 从 内 部 来 看 ， map 的 
map 被 实现 成 了 数组 的 数组 ， 因 此 在 提升 了 清楚 性 、 安 全 性 和 易 维 护 性 
的 同时 ， 在 空间 或 者 时 间 上 还 几乎 不 用 任何 开销 。 














总 而 言 之 ， BENE BOR S| BZA, mE enummap 。 如 果 你 所 
表示 的 这 种 关系 是 多 维 的 ， 束 使 用 enummap<..., EnumMap<...>> 。 应 用 程序 
的 程序 员 在 一 般 情况 下 都 不 使 用 Enum.ordinal ， 即 使 要 用 也 很 少 ， 因 此 
这 是 一 种 特殊 情况 〈 见 第 31 条 ) 。 


第 34 条 : 用 接口 模拟 可 伸缩 的 枚 举 


就 几乎 所 有 方面 来 看 ， 枚 举 类 型 都 优越 于 本 书 第 一 版 中 所 述 的 类 型 安全 
枚 举 模 式 [Bloch01]。 从 表面 上 看 ， 有 一 个 异 钊 与 可 伸缩 性 有 关 ， 这 个 姑 
常 可 能 处 在 原来 的 模式 中 ， 却 没有 得 到 语言 构造 的 支持 。 换 句 话 说 ， 使 
用 这 种 模式 ， 束 有 可 能 让 一 个 枚 举 类 型 去 扩展 力 一 个 枚 举 类 型 ， 利 用 这 
种 语言 特性 ， 则 不 可 能 这 么 做 。 这 绝 非 侦 然 。 枚 举 的 可 伸缩 性 最 后 证 明 
基本 上 都 不 是 什么 好 扣子。 扩展 类 型 的 元 素 为 基本 类 型 的 实例 ， 基 本 类 
型 的 实例 却 不 是 扩展 类 型 的 元 素 ， 这 样 很 是 混乱 。 目 前 还 没有 很 好 的 方 
法 来 枚 举 基本 类 型 的 所 有 元 素 及 其 扩展 。 最 终 ， 可 伸缩 性 会 于 人 致 设计 和 
实现 的 许多 方面 变 得 复杂 起 来 。 


也 就 是 说 ， 对 于 可 伸缩 的 枚 举 类 型 而 言 ， 至 少 有 一 种 具有 说 服 力 的 用 

例 ， 这 就 是 操作 吗 (operation code) ， 也 称 作 opcode 。 操 作 吗 是 指 这 
样 的 枚 举 类 型 : 它 的 元 素 表示 在 某 种 机 器 上 的 那些 操作 ， 例 如 第 30 条 中 
的 Operation ZR, 它 表 示 一 个 简单 的 计算 器 中 的 某 些 函 数 。 有 了 时候， 

要 尽 可 能 地 让 API 的 用 户 提 供 它 们 目 己 的 操作 ， 这 样 可 以 有 效 地 扩展 

API 所 提供 的 操作 集 。 


幸运 的 是 ， 有 一 种 很 好 的 方法 可 以 利用 枚 举 类 型 来 实现 这 种 效果 。 由 于 
枚 举 类 型 可 以 通过 给 操作 码 类 型 和 《属于 接口 的 标准 实现 的 ) 枚 举 定 义 
接口 ， 来 实现 任意 接口 ， 基 本 的 想法 就 是 利用 这 一 事实 。 例 如 ， 以 下 是 
第 30 条 中 的 operation 类 型 的 扩展 版 本 : 


// Emulated extensible enum using an interface 


























public interface Operation { 


double apply ( double x, double y) ; 


public enum BasicOperation implements Operation { 


PLUS( "+" ) { 


public double apply ( double x, double y) { return x+y; } 


}, 
MINUS( "-" ) { 

public double apply ( double x, double y) { return x - y; } 
}, 


TIMES( "*" DEA 
public double apply ( double x, double y) return BX 
}, 
DIVIDE( "/" ) { 
public double apply ( double x, double y) { return x/vy; } 
}; 
private final String symbol; 
BasicOperation(String symbol) { 
this .symbol = symbol; 
1; 
@Override public String toString () { 


return symbol; 


虽然 枚 举 类 型 ( pasicoperation ) 不 是 可 扩展 的 ， 但 接口 类 型 〈 
operation ) 则 是 可 扩展 的 ， 它 是 用 来 表示 API 中 的 操作 的 接口 类 
型 。 你 可 以 定义 另 一 个 枚 举 类 型 ， 它 实现 这 个 接口 ， 并 用 这 个 新 类 
型 的 实例 代替 基本 类 型 。 例 如 ， fai KIER RE SS ERRERA 
WIRE, ERE Cexponentiation) RA (remainder) 操作 组 成 。 
你 所 要 做 的 就 是 编写 一 个 枚 举 类 型 ， 让 它 实 现 Operation 接口 : 


// Emulated extension enum 





public enum ExtendedOperation implements Operation { 
EXP ( WAM ) { 
public double apply ( double x, double y) { 


return Math.pow(x, y); 


F} 
REMAINDER( "%" ) { 
public double apply ( double x, double y) { 


return Xx% y; 


private final String symbol; 
ExtendedOperation(String symbol) { 
this .symbol = symbol; 
} 
@Override public String toString () { 


return symbol; 


在 可 以 使 用 基础 操作 的 任何 地 方 ， 都 可 以 使 用 新 的 操作 ， 只 要 API 
是 被 写成 采用 接口 类 型 ( Operation ) 而 非 实 现 ( BasicOperation 

) 。 注 意 ， 在 枚 举 中 ， 不 必 像 在 不 可 扩展 的 枚 举 中 所 做 的 那样 ， 利 
用 特定 于 实例 的 方法 实现 来 声明 抽象 的 apy 方法 。 这 是 因为 抽象 
的 方法 ( apply ) 是 接口 ( Operation ) 的 一 部 分 。 


不 仅 可 以 在 任何 需要 “基本 枚 举 ” 的 地 方 单独 传递 一 个 “扩展 枚 举 ” 的 
实例 ， 而 且 除 了 那些 基本 类 型 的 元 系 之 外 ， 还 可 以 传递 完整 的 扩展 
枚 举 类 型 ， 并 使 用 它 的 元 素 。 例 如 ， 通 过 下 面 这 个 测试 程 夺 ， 体 验 
一 下 上 面 定义 过 的 所 有 扩展 过 的 操作 : 


public static void main (String[] args) { 











double x = Double.parseDouble(args[ 0 ]); 
doubly y = Double.parseDouble(args[ 1 ]); 


test(ExtendedOperation.class, x, y); 


private static <T extends Enum<T> & Operation> void test ( 
Class<T> opSet, double x, double y) { 
for (Operation op : opSet.getEnumConstants() ) 


System.out.printf( "%f %s %f = %f%n" , 


X, Op, y, Op-apply(x, y)); 


注意 扩展 过 的 操作 类 型 的 类 的 字面 文字 ( ExtendedOperation.class ) 
从 main 被 传递 给 了 test 方法 ， 来 描述 被 扩展 操作 的 集合 。 这 个 的 
字面 文字 充当 有 限制 的 类 型 令 牌 〈 见 第 29 条 ) 。 opset 参数 中 公认 
很 复杂 的 声明 ( <T extends Enum<T> & Operation> ) 确保 了 Class 对 象 既 
表示 枚 举 义 表示 operation 的 子 类 型 ， 这 正 是 所 有 历 元 素 和 执行 与 每 
个 元 素 相 关联 的 操作 时 所 需要 的 。 


第 二 种 方法 是 使 用 Collection<? extends Operation>  ， 这 是 个 有 限制 的 
通配符 类 型 (bounded wildcard type) 〈 见 第 28 条 ) ， 作 为 opset 
参数 的 类 型 : 


public static void main (String[] args) { 








double x = Double.parseDouble(args[ 0 ]); 
doubly y = Double.parseDouble(args[ 1 ]); 
test(Arrays.asList(ExtendedOperation.values()), x, y); 
} 
private static void test (Collection<? extends Operation> opSet, 
double x, double y) { 
for (Operation op : opSet.getEnumConstants()) 


System.out.printf( "%f %s %f = %f%n" , 


X, Op, y, Op.apply(x, y)); 


这 样 得 到 的 代码 没有 那么 复杂 ， tet 方法 也 比较 灵活 一 些 : ER 
许 调 用 者 将 多 个 实现 类 型 的 操作 合并 到 一 起 。 另 一 方面 ， 也 放弃 了 
在 指定 操作 上 使 用 Enumset ( 见 第 32 条 ) 和 enumman ( 见 第 33 条 ) AY 
功能 ， 因 此 ， 除 非 需要 灵活 地 合并 多 个 实现 类 型 的 操作 ， 人 否则 可 能 


最 好 使 用 有 限制 的 类 型 令 牌 。 
| 


4.000000 A 2.000000 = 16.000000 


4.000000 % 2.000000 = 0.000000 


用 接口 模拟 可 伸缩 枚 举 有 个 小 小 的 不 足 ， 既 无 法 将 实现 从 一 个 枚 举 
类 型 集成 到 另 一 个 枚 举 类 型 。 在 上 述 operation 的 示例 中 ， 保 存 和 
获取 与 茶 项 操作 相关 联 的 符号 的 逻辑 代码 ， 可 以 复制 到 
BasicOperation 和 Extendedoperation 中 。 在 这 个 例子 中 是 可 以 的 ， 
为 复制 的 代码 非常 少 。 如 果 共 享 功能 比较 多 ， 则 可 以 将 它 封装 在 一 
个 辅助 类 或 者 静态 辅助 方法 中 ， 来 避免 代码 的 复制 工作 。 


总 而 言 之 ， 虽然 无 法 编写 可 扩展 的 枚 举 类 型 ， 却 可 以 通过 编写 几 口 
以 及 实现 该 接口 的 基础 枚 举 类 型 ， 对 它 进行 模拟 。 这 样 允许 客户 
端 编 写 目 己 的 枚 举 来 实现 接口 。 如 果 API 是 根据 接口 编写 的 ， 那 么 
在 可 以 使 用 基础 枚 举 类 型 的 任何 地 方 ， 也 都 可 以 使 用 这 些 枚 举 。 


标记 接口 (marker interface) 是 没有 包含 方法 声明 的 接口 ， 而 只 是 
指明 (或 者 “标明 ”) 一 个 类 实现 了 具有 某 种 属性 的 接口 。 例 如 ， 考 
E Serializable 接口 ( 见 第 11 章 ) o 通过 实现 这 个 接口 ， 类 表明 它 
的 实例 可 以 被 写 到 objectoutputstream 【〔 或 者 “被 序列 化 ”) 。 











你 可 能 昕 说 过 标记 注解 ( 见 第 35 条 ) 使 得 标记 接口 过 时 了 。 这 种 断 
言 是 不 正确 的 。 标 记 接 口 有 两 点 胜 过 标记 注解 。 首 先 ， 也 是 最 重要 
的 一 点 是 ， 标记 接口 定义 的 类 型 是 有 被 标记 类 的 实例 实现 的 ;标记 
注解 则 没有 定义 这 样 的 类 型 。 这 个 类 型 允许 你 在 编译 时 捕捉 在 使 

用 标记 注解 的 情况 下 要 到 运行 时 才能 捕捉 到 的 错误 。 


WE serializable 标记 接口 而 言 ， 如 果 它 的 参数 没有 实现 该 接口 ， 
ObjectOutputStream.write(Object ) 方法 将 会 失败 。 令 人 不 解 的 是 ， 

ObjectOutputStream API 的 创建 者 在 声明 write 方法 时 并 没有 利用 
Serializable 接口 。 该 方法 的 参数 类 型 应 该 为 Serializable 而 非 

















Object o 因此 ， 试 着 在 没有 实现 Serializable 的 对 象 上 调用 
ObjectOutputStream.write ， 只 会 在 运行 时 失败 ， 但 也 并 不 一 定 如 此 。 


标记 接口 胜 过 标记 注解 的 另 一 个 有 点 事 ， 它 们 可 以 更 加 精确 地 进行 
锁定 。 如 果 注 解 类 型 利用 erarget(Elementrype.TyPE) 声明 ， 它 就 可 以 被 
应 用 到 任何 类 或 者 接口 。 假 设 有 一 个 标记 只 适用 于 特殊 接口 的 实 
现 。 如 果 将 它 定义 成 一 个 标记 接口 ， 就 可 以 用 它 将 唯一 的 接口 扩展 
成 它 适 用 的 接口 。 


set 接口 可 以 说 就 是 这 种 有 限制 的 标记 接口 (restricted marker 
interface) 。 它 只 适用 于 collection 子 类 型 ， 但 是 它 不 会 添加 除了 
Collection 方法 的 契约 ， 包括 add equals 和 hashCode o 但 是 很 容 
易 想 象 只 适用 于 茶 种 特殊 接口 的 子 类 型 的 标记 接口 ， 它 没有 改进 
接口 的 任何 方法 的 外 约 。 这 种 标记 接口 可 以 描述 整个 对 象 的 某 个 约 
束 条 件 ， 或 者 表明 实例 能 够 利用 其 他 条 个 类 的 方法 进行 处 理 《〈 就 想 
Serializable 接口 表明 实例 可 以 通过 ObjectOutputStream 进行 处 理 一 
BE) 











标记 注解 胜 过 标记 接口 的 最 大 优点 在 于 ， 它 可 以 通过 默认 的 方式 添 
加 一 个 或 者 多 个 注解 类 型 元 素 ， 给 一 被 使 用 的 注解 类 型 添加 更 多 的 
信息 [JLS，9.6]。 随 着 时 间 的 推移 ， 简 单 的 标记 注解 类 型 可 以 演变 
成 更 加 丰富 的 注解 类 型 。 这 种 演变 对 于 标记 接口 而 言 则 是 不 可 能 

iN, 因为 它 通 常 不 可 能 在 实现 接口 之 后 再 给 它 添加 方法 ( 见 第 18 

R) 。 


标记 注解 的 男 一 个 优点 在 于 ， 它 们 古 更 大 的 注解 机 制 的 一 部 分 。 因 
ct neem E E 
一 致 











那么 什么 时 候 应 该 使 用 标记 注解 ， 什 么 时 候 应 该 使 用 标记 接口 呢 ? 
很 显然 ， 如 果 标 记 是 应 用 到 任何 程序 元 素 而 不 是 类 或 者 接口 ， 惑 必 
须 使 用 注解 ， 因 为 只 有 类 和 接口 可 以 用 来 实现 或 者 扩展 接口 。 如 果 
标记 只 应 用 给 类 和 接口 ， 就 要 问 问 自 己 : 我 要 编写 一 个 还 是 多 个 只 
接受 有 这 种 标记 的 方法 呢 ? 如 果 是 这 种 情况 ， 就 应 该 优先 使 用 标记 
接口 而 非 注 解 。 这 样 你 就 可 以 用 接口 作为 相关 方法 的 参数 类 型 ， 它 
真正 可 以 为 你 提供 编译 时 进行 类 型 检查 的 好 处 。 


如 果 你 对 第 一 个 问题 的 答案 是 否定 的 ， 就 要 再 问 问 自己 : 我 要 永远 




















限制 这 个 标记 只 用 于 特殊 接口 的 元 素 吗 ? 如 果 是 ， 最 好 将 标记 定义 
成 该 接口 的 一 个 子 接口 。 如 果 这 两 个 问题 的 答案 都 是 否定 的 ， 或 许 
就 应 该 使 用 标记 注解 。 


总 而 言 之 ， 标 记 接口 和 标记 注解 都 各 有 用 处 。 如 果 要 定义 一 个 任何 
新 方法 都 不 会 与 之 关联 的 类 型 ， 标 记 接 口 就 是 最 好 的 选择 。 如 果 想 
要 标记 程序 元 系 而 非 类 和 接口 ， 考 碟 到 未 来 可 能 要 给 标记 添 加 更 多 
的 信息 ， 或 者 标记 要 适合 于 已 经 广泛 使 用 了 注解 类 型 的 框架 ， 那 么 
标记 注解 就 是 正确 的 选择 。 如 果 你 发 现 目 己 在 编写 的 是 目标 位 
ElementType.TYPE 的 标记 注解 类 型 ， 束 要 论点 时 间 考 虑 清楚 ， 它 是 否 
真 的 应 该 为 注解 类 型 ， 想 想 标 记 接 口 是 否 会 更 加 合适 呢 。 


从 茶 种 意义 上 说 ， 本 条 目 与 第 19 条 中 “如 有 果 不 想 定 义 类 型 就 不 要 使 
用 接口 * 的 说 法 相反 。 本 条 目 最 接近 的 意思 是 说 :如 果 想 要 定义 类 
型 ， 一 定 要 使 用 接口 。 
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